版本:7.0.0

SQLAllocConnect ​

功能描述 ​

分配连接句柄,其功能可被SQLAllocHandle函数替代。

原型 ​

c
SQLRETURN SQLAllocConnect(SQLHENV     EnvironmentHandle,    
                          SQLHDBC     *ConnectionHandle);

参数 ​

表 1 SQLAllocConnect参数

关键字

参数说明

EnvironmentHandle

一个有效的环境句柄,必须由SQLAllocEnv或SQLAllocHandle成功分配。

需先申请环境句柄,再申请连接句柄,连接句柄依赖于环境句柄。

ConnectionHandle

指向 SQLHDBC 类型变量的指针。函数执行成功后,该变量将存储新分配的连接句柄,后续的 SQLConnect、SQLDisconnect 等函数都会使用这个句柄。

返回值 ​

  • SQL_SUCCESS:表示调用正确。
  • SQL_SUCCESS_WITH_INFO:表示会有一些警告信息。
  • SQL_ERROR:表示分配连接句柄失败。
  • SQL_INVALID_HANDLE:表示输入的句柄无效。

注意事项 ​

为了使得代码更健壮并易于维护,建议使用标准化接口SQLAllocHandle替代SQLAllocConnect。

示例 ​

参见:示例