简单连接服务接口

OCILogon

功能描述

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

功能说明

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

接口信息

函数/过程

OCILogon语法如下：

sword OCILogon ( 
OCIEnv          *envhp,
                 OCIError        *errhp,
                 OCISvcCtx      **svchp,
                 const OraText   *username,
                 ub4              uname_len,
                 const OraText   *password,
                 ub4              passwd_len,
                 const OraText   *dbname,
                 ub4              dbname_len 
)

具体参数解释如下：

• envhp(IN)

  环境句柄。

• errhp(IN)

  错误句柄，当出现错误时，使用OCIErrorGet()获取错误信息。

• svchp(IN)

  服务上下文指针。

• username(IN)

  用户名，必须采用OCIEnvNlsCreate()的charset参数指定的编码。

• uname_len(IN)

  username的长度，与编码无关，以字节为单位。

• password(IN)

  用户密码，必须采用OCIEnvNlsCreate()的charset参数指定的编码。

• passwd_len(IN)

  password的长度，与编码无关，以字节为单位。

• dbname(IN)

  要连接数据库的名称，必须采用OCIEnvNlsCreate()的charset参数指定的编码。

• dbname_len(IN)

  dbname的长度，与编码无关，以字节为单位。

外部接口

无

其他说明

无

OCILogoff

功能描述

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

功能说明

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

数据相关性

无

接口信息

函数/过程

OCILogoff语法如下：

sword OCILogoff (
 OCISvcCtx      *svchp
                  OCIError       *errhp 
)

参数的解释如下：

• svchp(IN)

  服务上下文句柄。

• errhp(IN)

  错误句柄，可以通过OCIErrorGet()诊断错误信息。

其他说明

无