创建会话连接

在完成初始化XGCI编程环境后，环境句柄将作为父句柄进一步分配服务器句柄，服务器句柄承载着欲连接目标主机的IP地址、端口号、数据库名称等关键信息，这类信息会以缺省值的形式进行初始化，亦可通过XGCIHandleAttrSet()函数对服务器句柄相关的属性进行设置更改。使用XGCI与虚谷数据库服务新建会话连接相关的示例如下所示：

• 申请服务器句柄

  /* 申请服务器句柄,hdenv 为前文申请的环境句柄 */
    XuguCIHandleAlloc(hdenv, &hdsrv, HT_SERVER);

• 设置服务器句柄属性

  /* 设置服务器句柄访问主机地址属性值 */
    XuguCIHandleAttrSet(hdsrv, XuguCI_ATTR_SRV_IP, “127.0.0.1” , XuguCI_NTS);

• 申请会话句柄

  /* 申请会话句柄,hdsrv 为前文申请的服务器句柄 */
    XuguCIHandleAlloc(hdsrv, &hdsess, HT_SESSION);

• 新建会话连接

  /* 新建会话连接,hdsess 为前文申请的会话句柄 */
    XuguCISessionBegin(hdsess, “SYSDBA” , “SYSDBA”);

• 以字符串方式提供连接属性建立连接

  /* 根据连接串信息，创建一个连接会话的结构体 connp为返回的连接结构体指针*/
    XuguCIRETURN XuguCIConnectbyStr(char* conn_str, ConnnectionPointer * connp);

• 以连接属性结构体方式提供连接属性建立连接

  /* 根据连接结构体信息，创建一个连接会话的结构体 connp为返回的连接结构体指针 */
    XuguCIRETURN XuguCIConnectbyAttrs(Conn_Params* conn_params, ConnnectionPointer  *connp);