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。 否則，此例程可能會傳回下列其中一個值：

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

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

備註

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

以 NULL的 TargetVirtualClock 參數值呼叫 TmRecoverTransactionManager 的功能相當於呼叫 ZwRecoverTransactionManager。 使用非 NULLTargetVirtualClock 參數值呼叫 TmRecoverTransactionManager 的功能相當於呼叫 ZwRollforwardTransactionManager。

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

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

規格需求

需求 值
最低支援的用戶端 適用於 Windows Vista 和更新版本的作業系統版本。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL PASSIVE_LEVEL

另請參閱

ZwRecoverTransactionManager

ZwRollforwardTransactionManager