ODBC学习笔记—SQLAllocHandle

SQLAllocHandle

函数定义：

顾名思义，该函数就是用来分配句柄的，句柄类型参考参数详解。

SQLRETURN SQLAllocHandle(

     SQLSMALLINT     HandleType,

     SQLHANDLE     InputHandle,

     SQLHANDLE *     OutputHandlePtr);

参数详解：

HandleType ：输入变量

该变量只能从下列四个中选择其一：

SQL_HANDLE_ENV：用于申请环境句柄
SQL_HANDLE_DBC ：用于申请连接句柄

SQL_HANDLE_DESC：用于申请描述符句柄
SQL_HANDLE_STMT：用于申请语句句柄

InputHandle ：输入变量

该变量放入已经被分配好的前提句柄，如果第一个变量为环境句柄，则放入SQL_NULL_HANDLE即可，若果第一个变量为SQL_HANDLE_DBC，则第二个变量必须为已分配的环境句柄，如第一个变量为SQL_HANDLE_DESC，SQL_HANDLE_STMT则，第二个变量必须为已分配好的连接句柄。

OutputHandlePtr ：输出变量

该变量为一个指针变量，用于保存申请来的句柄，申请句柄类型为第一个变量，在定义该指针的时候需注意类型一致。

返回值：

返回值有四种：SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_INVALID_HANDLE, or SQL_ERROR.

查看详细错误信息可调用SQLGetDiagRec 函数（之后章节讲解）。

用法：

初始化指针变量：

SQLHENV  henv = NULL;

SQLHDBC  hdbc = NULL;

SQLHSTMT hstmt = NULL;

SQLHDESC hdesc=NULL;           

SQLRETURN rs = 0;   //使用指针的初始化

1.申请环境句柄：

rs = SQLAllocHandle(SQL_HANDLE_ENV,SQL_NULL_HANDLE,&henv);

2.申请连接句柄：

rs = SQLAllocHandle(SQL_HANDLE_ENV,SQL_NULL_HANDLE,&henv);

rs = SQLSetEnvAttr(henv,SQL_ATTR_ODBC_VERSION,(SQLPOINTER)SQL_OV_ODBC3,SQL_IS_INTEGER);

rs = SQLAllocHandle(SQL_HANDLE_DBC,henv,&hdbc);

3.申请语句句柄：

rs = SQLAllocHandle(SQL_HANDLE_ENV,SQL_NULL_HANDLE,&henv);

rs = SQLSetEnvAttr(henv,SQL_ATTR_ODBC_VERSION,(SQLPOINTER)SQL_OV_ODBC3,SQL_IS_INTEGER);

rs = SQLAllocHandle(SQL_HANDLE_DBC,henv,&hdbc);

rs = SQLConnect(hdbc,(UCHAR*)szDSN,SQL_NTS,(UCHAR*)szUID,SQL_NTS,(UCHAR*)szAuthStr,SQL_NTS);

rs = SQLAllocHandle(SQL_HANDLE_STMT,hdbc,&hstmt);

4.申请描述句柄：

rs = SQLAllocHandle(SQL_HANDLE_ENV,SQL_NULL_HANDLE,&henv);

rs = SQLSetEnvAttr(henv,SQL_ATTR_ODBC_VERSION,(SQLPOINTER)SQL_OV_ODBC3,SQL_IS_INTEGER);

rs = SQLAllocHandle(SQL_HANDLE_DBC,henv,&hdbc);

rs = SQLConnect(hdbc,(UCHAR*)szDSN,SQL_NTS,(UCHAR*)szUID,SQL_NTS,(UCHAR*)szAuthStr,SQL_NTS);

rs = SQLAllocHandle(SQL_HANDLE_DESC,hdbc,&hdesc);