| 规范： | DB2 CLI 1.1 | ODBC 1.0 | ISO CLI |
SQLDisconnect() 关闭与数据库连接句柄相关联的连接。
在调用此函数之后，调用 SQLConnect() 来连接另一个数据库，或调用 SQLFreeHandle()。
语法
SQLRETURN SQLDisconnect (SQLHDBC ConnectionHandle;) /* hdbc */
函数自变量
| 数据类型 | 自变量 | 使用 | 描述 |
|---|---|---|---|
| SQLHDBC | ConnectionHandle | 输入 | 连接句柄。 |
用法
如果应用程序在释放与连接相关联的所有语句句柄之前调用 SQLDisconnect()，则 DB2 CLI 在成功与数据库断开连接之后释放这些句柄。
如果返回了 SQL_SUCCESS_WITH_INFO，则表示成功地与数据库断开连接， 但会出现其它错误信息或特定于实现的信息。例如，在处理断开连接的后续事项时遇到问题，或者因为发生与应用程序无关的事件（如通信故障）而使得当前没有任何连接。
在调用 SQLDisconnect() 成功之后，应用程序可以重新使用 ConnectionHandle 来发出另一个 SQLConnect() 或 SQLDriverConnect() 请求。
返回码
诊断
| SQLSTATE | 描述 | 解释 |
|---|---|---|
| 01002 | 断开连接错误。 | 断开连接时出错。但是，断开连接成功。（函数返回 SQL_SUCCESS_WITH_INFO。） |
| 08003 | 连接已关闭。 | ConnectionHandle 自变量中指定的连接未打开。 |
| 58004 | 意外系统故障。 | 不可恢复的系统错误。 |
| HY001 | 内存分配失败。 | DB2 CLI 无法分配支持函数的执行或完成所需的内存。 |
| HY013 | 发生意外的内存处理错误。 | DB2 CLI 无法访问支持函数的执行或完成所需的内存。 |
限制
无。
相关参考