句柄属性管理接口

此处的属性是指OCI的句柄中字段的值，为了在使用OCI的过程中随时掌握当前句柄的状态，增加了属性管理相关的接口，包括OCIAttrSet、OCIAttrGet分别为属性设置、属性获取。

OCIAttrSet

功能描述

设置句柄或描述符属性的值。

功能说明

在使用句柄或描述符时需要设置属性值，以便于设置OCI信息，或执行期望动作。

接口信息

函数/过程

OCIAttrSet的语法如下：

sword OCIAttrSet ( void        *trgthndlp,
                   ub4          trghndltyp,
                   void        *attributep,
                   ub4          size,
                   ub4          attrtype,
                   OCIError    *errhp );

参数解释如下：

• trgthndlp(IN/OUT):指向属性被修改的句柄的指针。
• trghndltyp(IN/OUT):trgthndlp句柄的类型。
• attributep(IN):指向属性值的指针。
• size(IN):属性值的大小。大多数属性可以作为0传入。对于text*属性必须将ub4设置为字符串的长度（以字节为单位）。
• attrtype(IN):正在设置的属性类型。
• errhp(IN):当出现错误时，您可以传递给OCIErrorGet()以获取诊断信息的错误句柄。

其他说明

无

OCIAttrGet

功能描述

获取句柄或描述符属性的值。

功能说明

在使用句柄或描述符时需要获取属性值，以便于了解OCI信息。

接口信息

函数/过程

sword OCIAttrGet ( const void     *trgthndlp,
                   ub4             trghndltyp,
                   void           *attributep,
                   ub4            *sizep,
                   ub4             attrtype,
                   OCIError       *errhp );

参数解释如下：

• trgthndlp(IN):指向要获取的属性的句柄的指针。
• trghndltyp(IN):trgthndlp句柄的类型。
• attributep(OUT):指向属性值的指针。
• sizep(OUT):属性值的大小总是以字节为单位。对于大多数属性，这可以作为NULL传递。对于 text* 参数，必须传入指向 ub4 的指针以获取字符串的长度。
• attrtype(IN):正在获取的属性类型。
• errhp(IN/OUT):当出现错误时，您可以传递给OCIErrorGet()以获取诊断信息的错误句柄。

其他说明

无