(wdm.h) NtRollbackTransaction 函式
ZwRollbackTransaction 例程會起始指定交易的回復作業。
語法
__kernel_entry NTSYSCALLAPI NTSTATUS NtRollbackTransaction(
[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 Native System Services 例程的兩個版本。
針對來自內核模式驅動程式的呼叫，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、PowerIrpDDis |