更新日期:2024年09月11日
sword GCILogon2(
GCIEnv *envhp,
GCIError *errhp,
GCISvcCtx **svchp,
CONST GCIText *username,
ub4 uname_len,
CONST GCIText *password,
ub4 passwd_len,
CONST GCIText *dbname,
ub4 dbname_len,
ub4 mode
);
根据数据库服务名、用户名和密码,登录到一个指定的数据库服务上,并初始化相关上下
文句柄。可以使用现有连接池中的连接。
参数
输入
/输出
envhp
输入
GCI 环境句柄。对于连接池和会话池,这必须是在其中创建相
应池的池
errhp
输入/输出
错误信息句柄,该接口调用失败时将错误码及错误信息写入该
句柄
svchp
输入/输出
该接口内会自动生成一个当前环境句柄下的上下文句柄,并将
地址保存到该指针
username
输入
登录的用户名
uname_len
输入
登录的用户名的长度
password
输入
登录的口令
passwd_len
输入
登录的口令的长度
dbname
输入
数据库服务名
dbname_len
输入
数据库服务名的长度
mode
输入
连接模式,取值如下:
GCI_DEFAULT:缺省模式
GCI_LOGON2_CPOOL:连接池模式
如果执行成功,返回GCI_SUCCESS,否则返回GCI_ERROR。