SQLDisconnect 关闭与指定连接句柄关联的连接。
下表描述了 SQLDisconnect 的 SQLSTATE 和错误值。
SQLSTATE
错误值
错误消息
01000
-11001
General warning
01002
-11002
Disconnect error
08003
-11017
Connection not open
25000
-11032
Invalid transaction state
S1000
-11060
General error
S1001
-11061
Memory-allocation failure
S1010
-11067
Function-sequence error
08S01
-11301
A protocol error has been detected. Current connection is
closed.
用法
如果应用程序在 SQLBrowseConnect 返回 SQL_NEED_DATA 之后调用 SQLDisconnect ,
则在返回不同的返回码之前,驱动程序取消连接浏览过程并返回 hdbc 到未连接状态。
GBase 8s ODBC Driver 程序员指南
南大通用数据技术股份有限公司
- 218 -
如果应用程序在未完成的事务与连接句柄关联时调用 SQLDisconnect,则驱动程序返回
SQLSTATE 25000 (无效的事务状态),指示该事务没有变更,连接仍就打开。未完成的
事务是没有提交或回滚的 SQLTransact。
如果应用程序在是否与连接相关联 hstmt 之前调用 SQLDisconnect,则驱动程序在它从数
据源断开连接后释放剩余的 hstmt。然而,如果一个或多个与连接关联的 hstmts 仍在异步
执行,则 SQLDisconnect 返回 SQL_ERROR ,其中 SQLSTATE 的值为 S1010(函数序
列错误)。