描述符管理接口

描述符的管理接口是指，描述符的获取和设置，而当前只实现描述符中的参数描述符的获取接口DCIParamGet。可以分为描述符和属性。

描述符

下表为DCI的全部描述符，但并不是所有的描述符我们都已实现，只是实现了部分，最后一列标出了是否已经实现：

属性

属性是描述符的信息，由于我们只实现了参数描述符，在此我们只列出相关属性如下：

DCIParamGet

功能描述

返回由描述句柄或语句句柄中的位置指定的参数的描述符。

功能说明

此调用返回由描述句柄或语句句柄中的位置指定的参数的描述符。参数描述符总是由DCI库在内部分配。可以使用DCIDescriptorFree()释放它们。

接口信息

函数/过程

DCIParamGet的语法如下：

sword DCIParamGet ( const void        *hndlp,
        ub4                htype,
        DCIError          *errhp,
        void             **parmdpp,
        ub4                pos );

参数解释如下：

• Hndlp(IN)：语句句柄或描述句柄。

• htype(IN)：在 hndlp 参数中传递的句柄类型。 有效类型是：

  • DCI_DTYPE_PARAM，用于参数描述符。(暂不支持)

  • DCI_HTYPE_COMPLEXOBJECT，用于复杂对象检索句柄。(暂不支持)

  • DCI_HTYPE_STMT，用于语句句柄。

• errhp(IN/OUT)：当出现错误时，您可以传递给DCIErrorGet()以获取诊断信息的错误句柄。

• parmdpp(OUT)：pos 参数中给定位置的参数描述符，句柄类型为 DCI_DTYPE_PARAM。

• pos (IN)：语句句柄或描述句柄中的位置编号。 为这个位置返回一个参数描述符。

外部接口

无。

其它说明

无。

DCIParamSet

功能描述

设置由描述句柄或语句句柄中的位置指定的参数的描述符。

功能说明

此调用设置由描述句柄或语句句柄中的位置指定的参数的描述符。参数描述符总是由DCI库在内部分配。 可以使用DCIDescriptorFree()释放它们。

接口信息

函数/过程

DCIParamSet的语法如下：

sword DCIParamSet ( const void        *hndlp,
        ub4                htype,
        DCIError          *errhp,
        const void        *dscp,
        ub4                dtyp
        ub4                pos );

参数解释如下：

• hndlp(IN)：语句句柄或描述句柄。

• htype(IN)：在 hndlp 参数中传递的句柄类型。 有效类型是：

  • DCI_DTYPE_PARAM，用于参数描述符。(暂不支持)

  • DCI_HTYPE_COMPLEXOBJECT，用于复杂对象检索句柄。(暂不支持)

  • DCI_HTYPE_STMT，用于语句句柄。

• errhp(IN/OUT)：当出现错误时，您可以传递给DCIErrorGet()以获取诊断信息的错误句柄。

• dscp (IN)：复杂对象检索描述符指针。

• dtyp (IN)：COR 描述符的描述符类型是 OCI_DTYPE_COMPLEXObjecCTCOMP。

• pos (IN)：语句句柄或描述句柄中的位置编号。为这个位置返回一个参数描述符。

外部接口

无。

其它说明

无。