达梦(DM8)数据库函数dpi_alloc_handle

dpi_alloc_handle

函数

DPIRETURN

dpi_alloc_handle(

sdint2 hndl_type,

dhandle hndl_in,

dhandle *hdnl_out

);

功能：用于分配环境、连接、语句、描述符、lob、复合类型对象句柄。

参数

1) hndl_type

输入参数，需要分配句柄的类型，必须为下列值之一：

• DSQL_HANDLE_ENV
• DSQL_HANDLE_DBC
• DSQL_HANDLE_STMT
• DSQL_HANDLE_DESC
• DSQL_HANDLE_LOB_LOCATOR
• DSQL_HANDLE_OBJECT

2) hndl_in

输入参数，通过此句柄分配新的句柄，新句柄运行环境从属此句柄。

如果 hndl_type 为 DSQL_HANDLE_ENV，则这个值为 NULL；

如果 hndl_type 为 DSQL_HANDLE_DBC，则这个值必须是一个环境句柄；

如   果 hndl_type 为 DSQL_HANDLE_STMT   、   DSQL_HANDLE_DESC 或   者

DSQL_HANDLE_OBJECT，则这个值必须是一个连接句柄；

如果 hndl_type 为 DSQL_HANDLE_LOB_LOCATOR，则这个值必须是一个语句句柄。

3) hndl_out

输出参数，一个存放新分配句柄数据结构的缓冲区地址。

返回值

DSQL_SUCCESS

DSQL_SUCCESS_WITH_INFO

DSQL_ERROR

DSQL_INVALID_HANDLE

说明

如果函数执行失败，则 hndl_out 返回 NULL。