TmRecoverTransactionManager-Funktion (wdm.h)

  • Artikel

Die TmRecoverTransactionManager-Routine rekonstruiert den Zustand des Transaktions-Manager-Objekts (einschließlich aller Transaktionen, Einlistungen und Ressourcen-Manager) aus den Wiederherstellungsinformationen, die sich im Protokollstream befinden.

Syntax

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

Parameter

[in] Tm

Ein Zeiger auf ein Transaktions-Manager-Objekt. Um diesen Zeiger abzurufen, muss Ihre TPS-Komponente ObReferenceObjectByHandle aufrufen und das Objekthandle bereitstellen, das ein vorheriger Aufruf von ZwCreateTransactionManager oder ZwOpenTransactionManager bereitgestellt hat.

[in] TargetVirtualClock

Ein Zeiger auf einen wert der virtuellen Uhr. Dieser Parameter ist optional und kann NULL sein. Weitere Informationen zu diesem Parameter finden Sie im abschnitt Hinweise. Für Windows Vista muss dieser Parameter NULL sein.

Rückgabewert

TmRecoverTransactionManager gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Routine möglicherweise einen der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_NOT_IMPLEMENTED
 Für Windows Vista hat der Aufrufer einen Wert ohne NULL für den Parameter TargetVirtualClock angegeben.
STATUS_TM_VOLATILE
 Das angegebene Transaktions-Manager-Objekt verfügt nicht über eine Protokolldatei, sodass die Wiederherstellung nicht verfügbar ist.
STATUS_UNSUCCESSFUL
 Das angegebene Transaktions-Manager-Objekt befindet sich in einem unerwarteten Zustand.
 

Die Routine gibt möglicherweise andere NTSTATUS-Werte zurück.

Hinweise

Die TmRecoverTransactionManager-Routine ist eine zeigerbasierte Version der ZwRecoverTransactionManager-Routine .

Das Aufrufen von TmRecoverTransactionManager mit dem TargetVirtualClock-ParameterwertNULL entspricht funktional dem Aufrufen von ZwRecoverTransactionManager. Das Aufrufen von TmRecoverTransactionManager mit einem Nicht-NULLTargetVirtualClock-Parameterwert entspricht funktional dem Aufrufen von ZwRollforwardTransactionManager.

Weitere Informationen zu Wiederherstellungsvorgängen finden Sie unter Behandeln von Wiederherstellungsvorgängen.

Informationen zur Verwendung der TMXxx-Routinen von KTM anstelle von ZwXxx-Routinen finden Sie unter Verwenden von TmXxx-Routinen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Betriebssystemversionen.
Zielplattform Universell
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Weitere Informationen

ZwRecoverTransactionManager

ZwRollforwardTransactionManager