(wdm.h) NtRollbackTransaction 函数

ZwRollbackTransaction 例程为指定的事务启动回滚操作。

语法

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

参数

[in] TransactionHandle

以前对 ZwCreateTransactionZwOpenTransaction 的调用获取的事务对象的句柄。 句柄必须具有对对象的TRANSACTION_ROLLBACK访问权限。

[in] Wait

调用方将同步操作设置为 TRUE 的布尔值,对于异步操作,为 FALSE 。 如果此参数设置为 TRUE,则在回滚操作完成之前,不会返回调用。

返回值

如果操作成功,ZwRollbackTransaction 将返回STATUS_SUCCESS。 否则,此例程可能会返回以下值之一:

返回代码 说明
STATUS_OBJECT_TYPE_MISMATCH
TransactionHandle 参数指定的句柄不是事务对象的句柄。
STATUS_INVALID_HANDLE
对象句柄无效。
STATUS_ACCESS_DENIED
调用方无权访问事务对象。
STATUS_TRANSACTION_ALREADY_COMMITTED
无法回滚事务,因为它已提交。
STATUS_TRANSACTION_REQUEST_NOT_VALID
事务尚未提交,但其当前状态不允许回滚。
STATUS_PENDING
回滚通知已排队到资源管理器,调用方为 Wait 参数指定 FALSE
 

例程可能会返回其他 NTSTATUS 值

备注

有关 ZwRollbackTransaction 的详细信息,请参阅 处理回滚操作

NtRollbackEnlistmentZwRollbackEnlistment 是同一 Windows Native System Services 例程的两个版本。

对于内核模式驱动程序的调用,Windows Native System Services 例程的 NtXxxZwXxx 版本在处理和解释输入参数的方式可能有所不同。 有关例程 的 NtXxxZwXxx 版本之间的关系的详细信息,请参阅 使用本机系统服务例程的 Nt 和 Zw 版本

要求

   
最低受支持的客户端 在 Windows Vista 及更高版本的操作系统版本中可用。
目标平台 通用
标头 wdm.h (包括 Wdm.h、Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 符合性规则 HwStorPortProhibitedDDIs,PowerIrpDDis

另请参阅

使用本机系统服务例程的 Nt 和 Zw 版本

ZwCommitTransaction

ZwCreateTransaction

ZwOpenTransaction

ZwQueryInformationTransaction