语句句柄相关接口

OCIStmtGetBindInfo

功能描述

获取绑定和指示器变量名。

功能说明

获取语句句柄的绑定信息和指示器信息。

接口信息

函数/过程

OCIStmtGetBindInfo 语法如下：

sword   OCIStmtGetBindInfo   (OCIStmt *stmtp, OCIError *errhp, ub4 size, 
                              ub4 startloc,
                              sb4 *found, OraText *bvnp[], ub1 bvnl[],
                              OraText *invp[], ub1 inpl[], ub1 dupl[],
                              OCIBind **hndl); 

具体参数解释如下：

• stmtp (IN)： OCIStmtPrepare()准备的语句句柄。
• errhp (IN)：在发生错误时，可以传递给 OCIErrorGet ()用于诊断信息的错误句柄。
• size (IN)：在每个数组元素的个数。
• startloc (IN)：开始获取绑定信息的绑定变量的位置。
• found (IN)：abs（found） 给出了语句中绑定变量的总数，而不考虑起始位置。如果返回的绑定变量数小于提供的大小，则为正值，否则为负值。
• bvnp (OUT)：用于保存绑定变量名称的指针数组。如果环境设置为OCI_UTF16模式，则必须使用 UTF-16。
• bvnl (OUT)：用于保存每个 bvnp 元素长度的数组。长度以字节为单位。
• invp (OUT)：用于保存指示符变量名称的指针数组。如果环境设置为OCI_UTF16模式，则必须使用 UTF-16。
• inpl (OUT)：用于保存每个 invp 元素长度的指针数组。以字节数为单位。（暂不支持）
• dupl (OUT)：元素值为 0 或 1 的数组，具体取决于绑定位置是否与另一个绑定位置重复。（暂不支持）
• hndl (OUT)：一个数组，如果已对绑定位置进行了绑定，则返回绑定句柄。不会为重复项返回句柄。（暂不支持）

其他说明

无

OCIStmtRelease

功能描述

释放通过调用OCIStmtPrepare2（）获得的语句句柄。

功能说明

把语句句柄所占资源释放。目前只提供兼容性接口。

数据相关性

无

接口信息

函数/过程

OCIStmtRelease 语法如下：

sword OCIStmtRelease ( OCIStmt        *stmthp,  
                       OCIError       *errhp,
                       const OraText  *key,
                       ub4             keylen,
                       ub4             mode ); 

参数的解释如下：

• stmtp(IN/OUT): OCIStmtPrepare2（）获得的语句句柄。
• errhp(IN):当出现错误时，您可以传递给OCIErrorGet()以获取诊断信息的错误句柄。
• key(IN):仅对语句缓存有效。要与缓存中的语句关联的键。这是调用者传入的SQL字符串。如果传入NULL键，则该语句不会被标记。
• keylen(IN):仅对语句缓存有效,key的长度。
• mode(IN):指定各种操作模式。有效模式包括：
  • OCI_DEFAULT：默认模式
  • OCI_STRLS_CACHE_DELETE：仅对语句缓存有效。语句不再保存在缓存中。

其他说明

无