NtCommitTransaction 函数（wdm.h）

ZwCommitTransaction 例程为指定的事务启动提交作。

语法

__kernel_entry NTSYSCALLAPI NTSTATUS NtCommitTransaction(
  [in] HANDLE  TransactionHandle,
  [in] BOOLEAN Wait
);

[in] TransactionHandle

事务对象的句柄。组件从 ZwCreateTransaction 或 ZwOpenTransaction接收此句柄。句柄必须具有对对象的TRANSACTION_COMMIT访问权限。

[in] Wait

调用方为同步作 TRUE 或异步作 FALSE 的布尔值。如果此参数 TRUE，则调用在提交作完成后返回。

ZwCommitTransaction 如果作成功，则返回STATUS_SUCCESS。否则，此例程可能会返回以下值之一：

返回代码	描述
STATUS_OBJECT_TYPE_MISMATCH	为 TransactionHandle 参数指定的句柄不是事务对象的句柄。
STATUS_INVALID_HANDLE	指定的事务对象句柄无效。
STATUS_ACCESS_DENIED	调用方无权访问事务对象。
STATUS_TRANSACTION_SUPERIOR_EXISTS	调用方无法提交事务，因为存在高级事务管理器。
STATUS_TRANSACTION_ALREADY_ABORTED	无法提交事务，因为它已回滚。
STATUS_TRANSACTION_ALREADY_COMMITTED	事务已提交。
STATUS_TRANSACTION_REQUEST_NOT_VALID	已启动此事务的提交作。
STATUS_PENDING	提交通知已排到资源管理器，并为 Wait 参数指定的调用方指定 FALSE。

例程可能会返回其他NTSTATUS 值。

若要详细了解事务客户端如何使用 ZwCommitTransaction 例程，请参阅创建事务客户端。

有关提交作的详细信息，请参阅处理提交作。

对于内核模式驱动程序的调用，NtXxx 和 ZwXxx 版本的 Windows 本机系统服务例程的行为方式可能以不同的方式处理和解释输入参数。有关 NtXxx 与 ZwXxx 例程之间的关系的详细信息，请参阅使用 Nt 和 Zw 版本的本机系统服务例程。

要求	价值
最低支持的客户端	在 Windows Vista 和更高版本的 Windows 中可用。
目标平台	普遍
标头	wdm.h（包括 Wdm.h、Ntifs.h）
库	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 符合性规则	HwStorPortProhibitedDDI、PowerIrpDDis