ACILogon()

ACILogon()

作用：

创建一个单用户登录。

语法：

sword ACILogon ( ACIEnv          *envhp,
                 ACIError        *errhp,
                 ACISvcCtx      **svchp,
                 const OraText   *username,
                 ub4              uname_len,
                 const OraText   *password,
                 ub4              passwd_len,
                 const OraText   *dbname,
                 ub4              dbname_len );

参数：

• envhp (IN)

ACI的环境句柄

• errhp (IN/OUT)

错误句柄，该接口调用失败时，错误信息会存在该句柄上 ，调用 ACIErrorGet 获得错误信息。

• svchp (IN/OUT)

上下文句柄，如果指定的上下文句柄非空，那么在登录以后，会自动设置相关的连接句柄到该句柄上。如果指定的上下文句柄为空，那么ACI会自动分配一个上下文句柄输出，这个上下文句柄不需要通过调用 ACIHandleFree 来释放；当应用调用 ACILogoff 以后，ACI会自动释放这个句柄。

• username (IN)

登录的用户名. 必须是 ACIEnvNlsCreate 调用指定的charset 参数字符集的字符串。

• uname_len (IN)

登录的用户名长度。Username的字节长度，不是字符长度。

• password (IN)

登录的密码，必须是 ACIEnvNlsCreate 调用指定的charset 参数字符集的字符串.

• passwd_len (IN)

登录的密码长度。password的字节长度，不是字符长度。

• dbname (IN)

登录的TNS服务名/连接字符串，必须是 ACIEnvNlsCreate 调用指定的charset 参数字符集的字符串。

• dbname_len (IN)

登录的数据库名长度。dbname的字节长度，不是字符长度。

说明：

该调用分配传递给它的服务上下文句柄。 此调用还隐式分配与该会话关联的服务器和用户会话句柄。