ZwRollbackTransaction 函式 (wdm.h)
ZwRollbackTransaction 例程會起始指定交易的復原作業。
語法
NTSYSCALLAPI NTSTATUS ZwRollbackTransaction(
[in] HANDLE TransactionHandle,
[in] BOOLEAN Wait
);
參數
[in] TransactionHandle
先前呼叫 ZwCreateTransaction 或 ZwOpenTransaction 所取得之交易物件的句柄。 句柄必須具有物件的TRANSACTION_ROLLBACK存取權。
[in] Wait
呼叫端針對同步作業設定為 TRUE 的布爾值，或異步操作的 FALSE 。 如果此參數設定為 TRUE，則呼叫不會在復原作業完成之前傳回。
傳回值
如果作業成功，ZwRollbackTransaction 會傳回STATUS_SUCCESS。 否則，此例程可能會傳回下列其中一個值：
| 傳回碼 | Description |
|---|---|
|
TransactionHandle 參數指定的句柄不是交易物件的句柄。 |
|
物件句柄無效。 |
|
呼叫端沒有交易對象的適當存取權。 |
|
無法回復交易，因為它已經認可。 |
|
交易尚未認可，但其目前狀態不允許復原。 |
|
復原通知已排入佇列給資源管理員，而呼叫端已為 Wait 參數指定 FALSE。 |
例程可能會傳回其他 NTSTATUS值。
備註
如需 ZwRollbackTransaction 的詳細資訊，請參閱 處理復原作業。
NtRollbackEnlistment 和 ZwRollbackEnlistment 是相同 Windows 原生系統服務例程的兩個版本。
對於核心模式驅動程式的呼叫，Windows 原生系統服務例程的 NtXxx 和 ZwXxx 版本在處理和解譯輸入參數的方式可能會有不同的行為。 如需例程 NtXxx 和 ZwXxx 版本之間的關聯性詳細資訊，請參閱 使用 Nt 和 Zw 版本的原生系統服務例程。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows Vista 和更新版本的作業系統版本。 |
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | HwStorPortProhibitedDDIs (storport) 、 PowerIrpDDis (wdm) |