GCILogon
函数原型:
sword
GCILogon(
GCIEnv *envhp,
GCIError *errhp,
GCISvcCtx **svchp,
CONST GCIText *username,
ub4 uname_len,
CONST GCIText *password,
ub4 passwd_len,
CONST GCIText *dbname,
ub4 dbname_len
);
功能描述:
根据数据库服务名、
用户名和密码,
登录到一个指定的数据库服务上,
并初始化相关上
下文句柄。
参数说明:
envhp(输入)
操作所在的环境句柄
errhp(输入)
错误信息句柄,该接口调用失败时将错误码及错误信息写入该句柄。
svchp(输入/输出)
该接口内会自动生成一个当前环境句柄下的上下文句柄,并将地址保存到该指针。
username(输入)
登录的用户名
uname_len(输入)
登录的用户名的长度
password(输入)
登录的口令
passwd_len(输入)
登录的口令的长度
dbname(输入)
当GCI 参数connect_mode 为1 时表示数据库服务名
为2 时表示为数据源名称
dbname_len(输入)
dbname 的长度
返回值:
如果执行成功,返回GCI_SUCCESS,否则返回GCI_ERROR
注释:
建立连接之后需要通过调用GCILogoff 来断开连接。
当dbname 为空时使用默认数据库
GCI_demodb。