gbase_change_user
摘要:
更改用户,将参数db 的值作为gbase 连接句柄的当前默认数据库。在后续
查询中,对于不包含显式数据库区分符的表引用,该数据库是默认数据库。
如果不能确定已连接的用户或用户不具有使用数据库的权限,
gbase_change_user()将失败。在这种情况下,不会改变用户和数据库。
如果不打算拥有默认数据库,可将db 参数设置为NULL。
该命令总是会执行活动事务的ROLLBACK 操作,关闭所有的临时表,解锁所
有的锁定表,并复位状态,就像进行了新连接那样。即使未更改用户,也会出
现该情况。
语法:
gs_bool gbase_change_user(GBASE *gbase,
const char *user,
const char *passwd,
const char *db);
参数:
返回值:
0 表示成功,非0 值表示出现错误。
错误:
CR_COMMANDS_OUT_OF_SYNC 以不恰当的顺序执行了命令。
CR_SERVER_GONE_ERROR
GBase 服务器不可用。
CR_SERVER_LOST
在查询过程中丢失了与服务器的连接。
GBase 8a 程序员手册C API 篇
南大通用数据技术股份有限公司
- 11 -
CR_UNKNOWN_ERROR
出现未知错误。
ER_UNKNOWN_COM_ERROR
GBase 服务器未实施该命令
ER_ACCESS_DENIED_ERROR 用户或密码错误。
ER_BAD_DB_ERROR
数据库不存在。
ER_DBACCESS_DENIED_ERROR 用户没有访问数据库的权限。
ER_WRONG_DB_NAME
数据库名称过长。