达梦(DM)数据库函数dpi_get_env_attr

dpi_get_env_attr

函数

DPIRETURN

dpi_get_env_attr(

dhenv dpi_henv,

sdint4 attr_id,

dpointer val,

sdint4 buf_len,

sdint4 *val_len

);

功能

获取环境句柄属性。

参数

1) dpi_henv

输入参数，获取属性的环境句柄。

2) attr_id

输入参数，需要获取的属性。

3) val

输出参数，指向返回指定属性当前值的缓冲区的指针。

4) buf_len

输入参数，如果 val 返回的是字符串，则此参数为 val 缓冲区的长度。如果 val 返回

的不是字符串，则此参数忽略。

5) val_len

输出参数，指向返回 val 中可提供字符串的总长度的缓冲区的指针。如果 val 为 NULL，

则不返回长度，如果属性值为字符串，总长度大于等于 buf_len，则 val 值被截断且以 0 结尾。

返回值

DSQL_SUCCESS

DSQL_SUCCESS_WITH_INFO

DSQL_ERROR

DSQL_INVALID_HANDLE

说明

属性值参见函数 dpi_set_env_attr。