更新日期:2024年09月11日
函数原型:
sword
GCIHandleFree(
dvoid *hndlp,
CONST ub4 type
);
功能描述:
释放已分配的各类句柄,用于结束当前会话、断开数据库连接后的句柄清理。
参数说明:
hndlp(输入)
需要释放的句柄。
type(输入)
释放句柄的句柄类型。取值参见GCIHandleAlloc 函数中type 参数的取值,环境句柄如
下:
GCI_HTYPE_ENV
释放环境句柄
GCI_HTYPE_SVCCTX
释放上下文句柄
GCI_HTYPE_SERVER
释放服务句柄
GCI_HTYPE_SESSION
释放会话句柄
GCI_HTYPE_ERROR
释放错误句柄
GCI_HTYPE_STMT
释放语句句柄
GCI_HTYPE_DIRPATH_CTX
释放dirpath 上下文句柄
GCI_HTYPE_DIRPATH_COLUMN_ARRAY
释放dirpath 类数组句柄
GCI_HTYPE_DIRPATH_STREAM
释放dirpath 流句柄
GCI_HTYPE_DESCRIBE
释放描述符句柄
返回值:
如果释放成功,则返回GCI_SUCCESS,释放失败,则返回GCI_ERROR。
注释:
该函书需要配合GCIHandleAlloc 或GCIEnvCreate 使用。