版本:latest

SQLFreeConnect

功能描述

用于释放连接句柄,其功能可被SQLFreeHandle函数替代。

原型

c
SQLRETURN SQLFreeConnect(SQLHDBC     ConnectionHandle);

参数

表 1 SQLFreeConnect参数

关键字

参数说明

ConnectionHandle

要释放的连接句柄。

返回值

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

注意事项

如果SQLFreeConnect返回SQL_ERROR,连接句柄仍然有效。为了使得代码更健壮并易于维护,建议使用标准化接口SQLFreeHandle替代SQLFreeConnect。

示例

参见:示例