句柄属性管理接口

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

句柄

下图为DCI的全部句柄，最后一列标出了是否已经实现：

属性

其中属性是根据句柄或描述符进行分类的，由于DCI的属性较多，在此我们只列出支持的属性如下：

DCIAttrSet

功能描述

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

功能说明

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

接口信息

函数/过程

DCIAttrSet的语法如下：

sword DCIAttrSet ( void        *trgthndlp,
        ub4          trghndltyp,
        void        *attributep,
        ub4          size,
        ub4          attrtype,
        DCIError    *errhp );

参数解释如下：

• trgthndlp(IN/OUT)：指向属性被修改的句柄的指针。

• trghndltyp(IN/OUT)：trgthndlp句柄的类型。

• attributep(IN)：指向属性值的指针。

• size(IN)：属性值的大小。大多数属性可以作为0传入。对于text*属性必须将ub4设置为字符串的长度（以字节为单位）。

• attrtype(IN)：正在设置的属性类型。

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

外部接口

无。

其它说明

无。

DCIAttrGet

功能描述

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

功能说明

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

接口信息

函数/过程

sword DCIAttrGet ( const void     *trgthndlp,
        ub4             trghndltyp,
        void           *attributep,
        ub4            *sizep,
        ub4             attrtype,
        DCIError       *errhp );

参数解释如下：

• trgthndlp(IN)：指向要获取的属性的句柄的指针。

• trghndltyp(IN)：trgthndlp句柄的类型。

• attributep(OUT)：指向属性值的指针。

• sizep(OUT)：属性值的大小总是以字节为单位。对于大多数属性，这可以作为NULL传递。对于 text* 参数，必须传入指向 ub4 的指针以获取字符串的长度。

• attrtype(IN)：正在获取的属性类型。

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

外部接口

其它说明

无。