tmRollbackTransaction 函式 (wdm.h)
TmRollbackTransaction 例程會起始指定交易的復原作業。
語法
NTSTATUS TmRollbackTransaction(
[in] PKTRANSACTION Transaction,
[in] BOOLEAN Wait
);
參數
[in] Transaction
交易物件的指標。 若要取得此指標，您的元件必須呼叫 ObReferenceObjectByHandle ，並提供先前呼叫 ZwCreateTransaction 或 ZwOpenTransaction 的物件句柄。
[in] Wait
呼叫端針對同步作業設定為 TRUE 的布爾值，或異步操作的 FALSE 。 如果此參數設定為 TRUE，則呼叫不會在復原作業完成之前傳回。
傳回值
如果作業成功，TmRollbackTransaction 會傳回STATUS_SUCCESS。 否則，此例程可能會傳回下列其中一個值：
| 傳回碼 | Description |
|---|---|
|
無法回復交易，因為它已經認可。 |
|
交易尚未認可，但其目前狀態不允許復原。 |
|
復原通知已排入佇列給資源管理員，而呼叫端已為 Wait 參數指定 FALSE。 |
例程可能會傳回其他 NTSTATUS值。
備註
TmRollbackTransaction 例程是以指標為基礎的 ZwRollbackTransaction 例程版本。
如需何時使用 KTM 的 TmXxx 例程，而不是 ZwXxx 例程的相關信息，請參閱 使用 TmXxx 例程。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows Vista 和更新版本的作業系統版本。 |
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |