更新日期：2024年09月11日
GCIAttrGet
函数原型：
sword
GCIAttrGet(
CONST dvoid *trgthndlp,
ub4 trghndltyp,
dvoid *attributep,
ub4 *sizep,
ub4 attrtype,
GCIError *errhp
)；
功能描述：
获取句柄上的属性值
参数说明：
trgthndlp（输入）
要获取属性的句柄
trghndltyp（输入）
目标句柄的类型，取值如下：
GCI_HTYPE_STMT - 语句句柄
GCI_DTYPE_PARAM – 参数句柄
GCI_HTYPE_DIRPATH_CTX – 直接文件操作句柄
GCI_HTYPE_DIRPATH_COLUMN_ARRAY – 直接文件数据数组句柄
attributep（输出）
存放输出属性的缓冲区
sizep（输出）
存放输出属性大小的缓冲区
attrtype（输入）
要获取的属性，取值如下：
GCI_HTYPE_STMT
GCI_ATTR_PREFETCH_ROWS – 当前一次性返回结果集记录的行数
GCI_ATTR_NUM_COLS - 结果集中列的个数
GCI_ATTR_ROW_COUNT - 已经返回记录的总行数
GCI_ATTR_PARAM_COUNT – 获取绑定参数的个数
GCI_HTYPE_DESCRIBE
GCI_ATTR_PARAM-当前描述符参数对象
GCI_DTYPE_PARAM
GCI_HTYPE_RESULT_COL_ATTR
GCI_ATTR_DATA_SIZE – 列的数据大小
GCI_ATTR_DATA_TYPE – 列的数据类型
GCI_ATTR_NAME – 列的名称
GCI_ATTR_PRECISION – 列的精度
GCI_ATTR_SCALE – 列的刻度
GCI_ATTR_TYPE_NAME- 数据类型名称
GCI_ATTR_LIST_COLUMNS
同GCI_HTYPE_RESULT_COL_ATTR 属性
GCI_ATTR_LIST_COLUMNS
GCI_ATTR_LIST_ARGUMENTS
GCI_ATTR_NAME – 直接文件操作时设置列的名称
GCI_ATTR_DATA_TYPE – 直接文件操作时设置列的数据类型
GCI_ATTR_DATA_SIZE – 直接文件操作时设置列的数据类型大小
GCI_ATTR_PRECISION – 直接文件操作时设置列的精度
GCI_ATTR_SCALE – 直接文件操作时设置列的刻度
GCI_ATTR_TYPE_NAME- 数据类型名称
GCI_PTYPE_PKG
GCI_ATTR_LIST_SUBPROGRAMS-数据库程序对象列表
GCI_ATTR_NUM_PARAMS-对象参数的个数
GCI_ATTR_PTYPE-数据库对象类型
GCI_PTYPE_PROC
GCI_ATTR_LIST_ARGUMENTS-数据库对象参数列表
GCI_ATTR_NUM_PARAMS-对象参数的个数
GCI_PTYPE_TABLE
GCI_PTYPE_VIEW
GCI_ATTR_LIST_COLUMNS-表或视图列属性列表
GCI_ATTR_NUM_COLUMNS-列数
GCI_HTYPE_DIRPATH_CTX
GCI_ATTR_LIST_COLUMNS – 返回描述表中各列信息的参数句柄
GCI_HTYPE_DIRPATH_COLUMN_ARRAY
GCI_ATTR_NUM_ROWS – 当前缓冲区允许一次性最大设置的记录行数
errhp（输入）
错误信息句柄，该接口调用失败时将错误码和错误信息写入该句柄
返回值：
如果执行成功，则返回GCI_SUCCESS，否则返回GCI_ERROR