Skip to content

XGCIHandleAlloc

函数原型

XuguCIRETURN Xugu_API XuguCIHandleAlloc( 
    XuguCIHANDLE parenthndp, 
    XuguCIHANDLE * hndlpp, 
    HANDLE_TYPE type 
);

功能

返回一个被分配的和初始化的句柄的指针。

参数

  • parenthndp:一个环境句柄,也可称为父句柄。
  • hndlpp:接收被申请句柄的地址。
  • type:指定要被分配的句柄的类型。允许的类型如表1所示。
    属性描述
    HT_ENV分配C类型XGCIEnv的环境句柄
    HT_SERVER分配C类型XGCIServer的服务句柄
    HT_SESSION分配C类型XGCISession的会话句柄
    HT_CONNPOOL分配C类型XGCIConnectPool连接池句柄
    HT_STATEMENT分配C类型XGCIStatement语句句柄
    HT_ERR分配C类型XGCIError错误句柄

返回值

属性描述
XGCI_SUCCESS成功
XGCI_SUCCESS_WITH_INFO成功并附带信息
XGCI_ERROR返回错误
XGCI_INVALID_HANDLE无效句柄
XGCI_INVALID_ARG无效参数
XGCI_NET_ERROR网络错误
XGCI_MEM_ERROR内存错误