达梦(DM)数据库函数dpi_set_desc_rec

dpi_set_desc_rec

函数

DPIRETURN

dpi_set_desc_rec(

dhdesc dpi_desc,

sdint2 rec_num,

sdint2 type,

sdint2 sub_type,

slength length,

sdint2 prec,

sdint2 scale,

dpointer data_ptr,

slength* str_len,

slength* ind_ptr

);

功能

设置复合的描述符域的信息。这些信息可以影响所绑定列或者参数的数据类型和绑定的

缓冲区信息。

参数：

1) dpi_desc

输入参数，描述符句柄。不能为 IRD 句柄。

2) rec_num

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

设置的为书签列。此参数值必须大于等于 0。如果此参数的值大于 DSQL_DESC_COUNT 的

值，则 DSQL_DESC_COUNT 的值改变为 rec_num。

3) type

输入参数，设置描述符记录 DSQL_DESC_TYPE 域的值。

4) sub_type

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

DSQL_DESC_DATETIME_INTERVAL_CODE 域的值。

5) length

输入参数，此参数值设置描述符记录的 DSQL_DESC_OCTET_LENGTH 域的值。

6) prec

输入参数，此参数值设置描述符记录的 DSQL_DESC_PRECISION 域的值。

7) scale

输入参数，此参数值设置描述符记录的 DSQL_DESC_SCALE 域的值。

8) data_ptr

延缓输入或输出参数，此参数值设置描述符记录的 DSQL_DESC_DATA_PTR 域的值。

data_ptr 可以设置为 NULL。如果 data_ptr 设置为 NULL，dpi_desc 又与 ARD 关联，则这意

味着清空了绑定信息。

9) str_len

延 缓 输 入 或 输 出 参 数 ， 此 参 数 值 设 置 描 述 符 记 录 的

DSQL_DESC_OCTET_LENGTH_PTR 域的值。str_len 可以设置为 NULL。

10)   ind_ptr

延缓输入或输出参数，此参数值设置描述符记录的 DSQL_DESC_INDICATOR_PTR  域

的值。ind_ptr 可以设置为 NULL。

返回值

DSQL_SUCCESS

DSQL_SUCCESS_WITH_INFO

DSQL_ERROR

DSQL_INVALID_HANDLE

说明：

具体参见 dpi_set_desc_field 函数说明。