SQLEndTran － 请求 COMMIT 或 ROLLBACK

用途

SQLEndTran() 向与连接相关联的所有语句上的所有活动操作请求 COMMIT 或 ROLLBACK 操作。

语法

SQLRETURN   SQLEndTran       (SQLSMALLINT        HandleType,
                              SQLHANDLE         Handle,
                              SQLSMALLINT        Completion Type);

函数自变量

表 42. SQLEndTran 自变量

用法

HandleType

句柄类型标识。只允许 SQL_HANDLE_DBC（连接句柄）。

Handle

由 HandleType 所指示的类型的句柄。

CompletionType

下列两个值之一：

• SQL_COMMIT

• SQL_ROLLBACK

在手工落实方式下，必须在调用 SQLDisconnect() 之前调用 SQLEndTran()。如果不在 SQLDisconnect() 之前调用 SQLEndTran()，则会回滚更新数据库的操作（自从启动上一事务后）。

当执行 ROLLBACK 时，将清除所有语句句柄。

如果应用程序在以手工方式进行时过早地崩溃或终止，则自上一次 COMMIT 以来所作的更新就会丢失。必须在调用断开连接之前调用 SQLEndTran()。

返回码

• SQL_SUCCESS
• SQL_SUCCESS_WITH_INFO
• SQL_ERROR
• SQL_INVALID_HANDLE

诊断

表 43. SQLEndTran SQLSTATE

限制

无。

相关参考

• DB2 CLI 函数描述的关键
• DB2 CLI 函数摘要
• SQLSetConnectAttr － 设置与连接相关的选项