达梦(DM)数据库函数dpi_get_desc_rec

dpi_get_desc_rec

函数

DPIRETURN

dpi_get_desc_rec(

dhdesc dpi_desc,

sdint2 rec_num,

sdbyte *name_buf,

sdint2 name_buf_len,

sdint2 *name_len,

sdint2 *type,

sdint2 *sub_type,

slength *length,

sdint2 *prec,

sdint2 *scale,

sdint2 *nullable

);

功能

获取复合的描述符记录的域的当前设置或值。

参数：

1) dpi_desc

输入参数，描述符句柄。

2) rec_num

输入参数，包含所要获取域的描述符记录的索引号。此参数从 0 起始。当为 0 时，表示

所设置的为书签列。此参数值必须大于等于 0 且小于等于 DSQL_DESC_COUNT 的值。

3) name_buf

输出参数，指向返回 DSQL_DESC_NAME 域值的缓冲区的指针。

4) name_buf_len

输入参数，name_buf 缓冲区的字节长度。

5) name_len

输出参数，指向返回可填充 name_buf 的数据的总长度的缓冲区的指针。如果总长度大

于或等于 name_buf_len，则 name_buf 中的数据被截断，并以 0 结尾。

6) type

输出参数，指向返回 DSQL_DESC_TYPE 域值的缓冲区的指针。

7) sub_type

输入参数，对于类型为   DSQL_DT   或者   DSQL_INTERVAL   的记录，此参数值设置

DSQL_DESC_DATETIME_INTERVAL_CODE 域的值

8) length

输出参数，指向返回 DSQL_DESC_OCTET_LENGTH 域值的缓冲区指针。

9) prec

输出参数，指向返回 DSQL_DESC_PRECISION 域值的缓冲区指针。

10)   scale

输出参数，指向返回 DSQL_DESC_SCALE 域值的缓冲区指针。

11)   nullable

输出参数，指向返回 DSQL_DESC_NULLABLE 域值的缓冲区指针。

返回值

DSQL_SUCCESS

DSQL_SUCCESS_WITH_INFO

DSQL_ERROR

DSQL_INVALID_HANDLE

DSQL_NO_DATA

说明：

具体参见 dpi_set_desc_field 说明。