ACIAttrGet()

ACIAttrGet()

作用:

获取句柄属性

语法:

sword ACIAttrGet ( const void     *trgthndlp,
                   ub4             trghndltyp,
                   void           *attributep,
                   ub4            *sizep,
                   ub4             attrtype,
                   ACIError       *errhp );

参数:

  • trgthndlp (IN)

要获取属性的句柄

  • trghndltyp (IN)

参数句柄的类型,比如

ACI_DTYPE_PARAM:获取参数描述符的属性。

ACI_HTYPE_STMT:获取语句句柄的属性

更多句柄类型参阅《句柄管理》章节

  • attributep (OUT)

存储获取属性值的缓冲区

  • sizep (OUT)

返回attributep 缓冲区中时间数据的字节大小。对于非字符串类型的属性,这个参数可以传入NULL,而对于字符串类型的,需要一个ub4的变量地址传入。

  • attrtype (IN)

要获取的属性类型,详细参阅《附录A:句柄或者描述符属性》章节

  • errhp (IN/OUT)

错误句柄,该接口调用失败时,错误信息会存在该句柄上 ,调用 ACIErrorGet 获得错误信息。

说明:

该调用用于获取句柄的特定属性。 ACI_DTYPE_PARAM用于执行隐式和显式描述。 参数描述符也用于直接路径加载。 对于隐式描述,参数描述符具有每个选择列表的列描述。 对于显式描述,参数描述符具有您要描述的每个架构对象的描述信息。如果顶级参数描述符具有本身就是描述符的属性,请在后续对 ACIAttrGet 的调用中使用ACI_ATTR_PARAM作为属性类型,以获取环境或语句句柄中的Unicode信息。