TmRecoverTransactionManager-Funktion (wdm.h)
Die TmRecoverTransactionManager Routine rekonstruiert den Status des Transaktions-Manager-Objekts (einschließlich aller Transaktionen, Listen und Ressourcenmanager) aus den Wiederherstellungsinformationen, die sich im Protokolldatenstrom 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 angeben, das ein vorheriger Aufruf von ZwCreateTransactionManager oder ZwOpenTransactionManager bereitgestellt hat.
[in] TargetVirtualClock
Ein Zeiger auf einen virtuellen Uhrwert. Dieser Parameter ist optional und kann NULL-werden. Weitere Informationen zu diesem Parameter finden Sie im folgenden 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 |
|---|---|
|
Für Windows Vista hat der Aufrufer einen Nicht-NULL- Wert für den parameter TargetVirtualClock angegeben. |
|
Das angegebene Transaktions-Manager-Objekt verfügt nicht über eine Protokolldatei, sodass die Wiederherstellung nicht verfügbar ist. |
|
Das angegebene Transaktions-Manager-Objekt befindet sich in einem unerwarteten Zustand. |
Die Routine gibt möglicherweise andere NTSTATUS-Wertezurück.
Bemerkungen
Die TmRecoverTransactionManager Routine ist eine zeigerbasierte Version der ZwRecoverTransactionManager Routine.
Das Aufrufen TmRecoverTransactionManager- mit einem TargetVirtualClock Parameterwert von NULL- entspricht funktionell dem Aufrufen ZwRecoverTransactionManager. Das Aufrufen TmRecoverTransactionManager- mit einem nichtNULL-TargetVirtualClock Parameterwert entspricht funktionell dem Aufrufen ZwRollforwardTransactionManager.
Weitere Informationen zu Wiederherstellungsvorgängen finden Sie unter Behandeln von Wiederherstellungsvorgängen.
Informationen dazu, wann SIE die TmXxx Routinen anstelle von ZwXxx Routinen verwenden, finden Sie unter Using TmXxx Routines.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Betriebssystemversionen. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | PASSIVE_LEVEL |