简单连接服务接口

DCILogon

功能描述

创建一个简单的登录会话。

功能说明

该调用分配传递给它的服务上下文句柄，并发出创建指定数据库连接的请求。该调用隐式分配与会话关联的服务句柄和用户会话句柄，可以通过调用OCLArrayDescriptorAlloc()函数来检索这些句柄。

接口信息

函数/过程

DCILogon语法如下：

sword DCILogon ( 
        DCIEnv          *envhp,
        DCIError        *errhp,
        DCISvcCtx      **svchp,
        const OraText   *username,
        ub4              uname_len,
        const OraText   *password,
        ub4              passwd_len,
        const OraText   *dbname,
        ub4              dbname_len 
)

具体参数解释如下：

• envhp(IN)：环境句柄。

• errhp(IN)：错误句柄，当出现错误时，使用DCIErrorGet()获取错误信息。

• svchp(IN)：服务上下文指针。

• username(IN)：用户名，必须采用DCIEnvNlsCreate()的charset参数指定的编 码。

• uname_len(IN)：username的长度，与编码无关，以字节为单位。

• password(IN)：用户密码，必须采用DCIEnvNlsCreate()的charset参数指定的编 码。

• passwd_len(IN)：password的长度，与编码无关，以字节为单位。

• dbname(IN)：要连接数据库的名称，必须采用DCIEnvNlsCreate()的charset参 数指定的编码。

• dbname_len(IN)：dbname的长度，与编码无关，以字节为单位。

外部接口

无。

其它说明

无。

DCILogoff

功能描述

该调用用来释放传递给DCILogon的服务上下文句柄，断开由DCILogon建立的数据库连接。

功能说明

该调用用来终止被使用的DCILogon创建的连接和会话。对于连接池，该调用将关闭会话并将会话返回给连接池；对于会话池，该调用将返回会话或者返回连接对给会话池。

接口信息

函数/过程

DCILogoff语法如下：

sword DCILogoff (
        DCISvcCtx      *svchp
        DCIError       *errhp 
)

参数的解释如下：

• svchp(IN)：服务上下文句柄。

• errhp(IN)：错误句柄，可以通过DCIErrorGet()诊断错误信息。

外部接口

无。

其它说明

无。