版本:latest

SQLFreeHandle

功能描述

释放环境、连接、语句句柄,可替代SQLFreeEnv、SQLFreeConnect及SQLFreeStmt。

原型

c
SQLRETURN SQLFreeHandle(SQLSMALLINT   HandleType,    
                        SQLHANDLE     Handle);

参数

表 1 SQLFreeHandle参数

关键字

参数说明

HandleType

SQLFreeHandle要释放的句柄类型。必须为下列值之一:

  • SQL_HANDLE_ENV
  • SQL_HANDLE_DBC
  • SQL_HANDLE_STMT

如果HandleType不是这些值之一,SQLFreeHandle返回SQL_ERROR。

Handle

要释放的句柄。

返回值

  • SQL_SUCCESS:表示调用正确。
  • SQL_SUCCESS_WITH_INFO:表示会有一些警告信息。
  • SQL_ERROR:表示执行失败,句柄未被释放。
  • SQL_INVALID_HANDLE:表示传入的句柄无效。

注意事项

如果SQLFreeHandle返回SQL_ERROR,句柄仍然有效。

示例

参见:示例