ODBC 程序所需的句柄类型现列示如下：

♦  使用 ODBC 句柄：

1. 调用 SQLAllocHandle 函数。

   SQLAllocHandle 采用以下参数：

   • 要分配的项所属类型的标识符

   • 父项的句柄

   • 要分配的句柄的位置指针

     有关完整说明，请参见 Microsoft ODBC 程序员参考中的  SQLAllocHandle。

2. 在随后的函数调用中使用该句柄。

3. 使用 SQLFreeHandle 释放对象。

   SQLFreeHandle 采用以下参数：

   • 要释放的项所属类型的标识符

   • 要释放的项的句柄

     有关完整说明，请参见 Microsoft《ODBC 程序员参考》中的  SQLFreeHandle。

示例

下面的代码段将分配和释放一个环境句柄：

SQLHENV env;
SQLRETURN retcode;
retcode = SQLAllocHandle( 
      SQL_HANDLE_ENV, 
      SQL_NULL_HANDLE, 
      &env ); 
if( retcode == SQL_SUCCESS 
    || retcode == SQL_SUCCESS_WITH_INFO ) {
  // success: application Code here
}
SQLFreeHandle( SQL_HANDLE_ENV, env );

有关返回代码和错误处理的详细信息，请参见处理错误。