版本:latest

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。

示例

参见:示例