共用方式為

TmRecoverTransactionManager 函式 （wdm.h）

  • 發行項

TmRecoverTransactionManager 例程會從記錄數據流中的復原資訊重建交易管理員物件的狀態（包括所有交易、登記和資源管理員）。

語法

NTSTATUS TmRecoverTransactionManager(
  [in] PKTM           Tm,
  [in] PLARGE_INTEGER TargetVirtualClock
);

參數

[in] Tm

交易管理員物件的指標。 若要取得此指標，您的 TPS 元件必須呼叫 ObReferenceObjectByHandle，並提供先前呼叫 ZwCreateTransactionManager 或 ZwOpenTransactionManager 的物件句柄。

[in] TargetVirtualClock

虛擬時鐘值的指標。 這個參數是選擇性的，而且可以 NULL。 如需此參數的詳細資訊，請參閱下列一節。 針對 Windows Vista，此參數必須 NULL。

傳回值

TmRecoverTransactionManager 如果作業成功，就會傳回STATUS_SUCCESS。 否則，此例程可能會傳回下列其中一個值：

傳回碼 描述
STATUS_NOT_IMPLEMENTED
 針對 Windows Vista，呼叫端為 TargetVirtualClock 參數指定了非NULL 值。
STATUS_TM_VOLATILE
 指定的交易管理員對象沒有記錄檔，因此無法使用復原。
STATUS_UNSUCCESSFUL
 指定的交易管理員對象處於非預期狀態。
 

例程可能會傳回其他 NTSTATUS 值。

言論

TmRecoverTransactionManager 例程是以指標為基礎的 ZwRecoverTransactionManager 例程。

使用 TargetVirtualC lock 呼叫 tmRecoverTransactionManager，NULL 參數值的功能相當於呼叫 ZwRecoverTransactionManager。 使用非NULLTargetVirtualClock 参數值呼叫 TmRecoverTransactionManager 的功能相當於呼叫 ZwRollforwardTransactionManager。

如需復原作業的詳細資訊，請參閱 處理復原作業。

如需何時使用 KTM 的 TmXxx 例程，而不是 使用 ZwXxx 例程，請參閱使用 TmXxx 例程。

要求

要求 價值
最低支援的用戶端 適用於 Windows Vista 和更新版本的作業系統版本。
目標平臺 普遍
標頭 wdm.h （包括 Wdm.h、Ntddk.h、Ntifs.h）
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

另請參閱

ZwRecoverTransactionManager

ZwRollforwardTransactionManager