SQLAllocHandle

功能描述

分配环境、连接、语句句柄，可替代SQLAllocEnv、SQLAllocConnect及SQLAllocStmt。

原型

SQLRETURN SQLAllocHandle(SQLSMALLINT   HandleType,    
                         SQLHANDLE     InputHandle,     
                         SQLHANDLE     *OutputHandlePtr);

参数

表 1 SQLAllocHandle参数

关键字	参数说明
HandleType	由SQLAllocHandle分配的句柄类型。必须为下列值之一： SQL_HANDLE_ENV（环境句柄） SQL_HANDLE_DBC（连接句柄） SQL_HANDLE_STMT（语句句柄）申请句柄顺序为，先申请环境句柄，再申请连接句柄，最后申请语句句柄，后申请的句柄都要依赖它前面申请的句柄。
InputHandle	将要分配的新句柄的类型。如果HandleType为SQL_HANDLE_ENV，则这个值为SQL_NULL_HANDLE。如果HandleType为SQL_HANDLE_DBC，则这一定是一个环境句柄。如果HandleType为SQL_HANDLE_STMT，则它一定是一个连接句柄。
OutputHandlePtr	输出参数：一个缓冲区的指针，此缓冲区以新分配的数据结构存放返回的句柄。

关键字

参数说明

HandleType

由SQLAllocHandle分配的句柄类型。必须为下列值之一：

SQL_HANDLE_ENV（环境句柄）
SQL_HANDLE_DBC（连接句柄）
SQL_HANDLE_STMT（语句句柄）

申请句柄顺序为，先申请环境句柄，再申请连接句柄，最后申请语句句柄，后申请的句柄都要依赖它前面申请的句柄。

InputHandle

将要分配的新句柄的类型。

如果HandleType为SQL_HANDLE_ENV，则这个值为SQL_NULL_HANDLE。
如果HandleType为SQL_HANDLE_DBC，则这一定是一个环境句柄。
如果HandleType为SQL_HANDLE_STMT，则它一定是一个连接句柄。

OutputHandlePtr

输出参数：一个缓冲区的指针，此缓冲区以新分配的数据结构存放返回的句柄。

返回值

SQL_SUCCESS：表示调用正确。
SQL_SUCCESS_WITH_INFO：表示会有一些警告信息。
SQL_ERROR：表示分配相应句柄失败。
SQL_INVALID_HANDLE：表示传入的句柄无效。

示例

参见：示例

SQLAllocHandle ​

功能描述 ​

原型 ​

参数 ​

返回值 ​

示例 ​

SQLAllocHandle

功能描述

原型

参数

返回值

示例