ZwRecoverTransactionManager-Funktion (wdm.h)

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

Syntax

NTSYSCALLAPI NTSTATUS ZwRecoverTransactionManager(
  [in] HANDLE TransactionManagerHandle
);

Parameter

[in] TransactionManagerHandle

Ein Handle für ein Transaktions-Manager-Objekt , das durch einen vorherigen Aufruf von ZwCreateTransactionManager oder ZwOpenTransactionManager abgerufen wurde. Das Handle muss TRANSACTIONMANAGER_RECOVER Zugriff auf das Objekt haben.

Rückgabewert

ZwRecoverTransactionManager 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_OBJECT_TYPE_MISMATCH	Das angegebene Handle ist kein Handle für ein Transaktions-Manager-Objekt.
STATUS_INVALID_HANDLE	Ein Objekthandle ist ungültig.
STATUS_ACCESS_DENIED	Der Aufrufer hat keinen entsprechenden Zugriff auf das Transaktions-Manager-Objekt.
STATUS_TM_VOLATILE	Das Transaktions-Manager-Objekt ist volatil, sodass seine Transaktionen nicht wiederhergestellt werden können.
STATUS_UNSUCCESSFUL	Das Transaktions-Manager-Objekt befindet sich nicht in einem Zustand, der die Wiederherstellung zulässt.

 

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

Hinweise

Die ZwRecoverTransactionManager-Routine versucht, den Zustand des Transaktions-Manager-Objekts, einschließlich aller Transaktionen, Einlistungen und Ressourcenmanager, aus den Wiederherstellungsinformationen im Protokolldatenstrom des Objekts zu rekonstruieren, beginnend beim letzten Neustartbereich , den KTM erstellt hat, und endet am Ende des Datenstroms.

Um bis zu einer bestimmten virtuellen Zeit wiederherzustellen, verwenden Sie die ZwRollforwardTransactionManager-Routine anstelle von ZwRecoverTransactionManager.

Ihre TPS-Komponente muss ZwRecoverTransactionManager aufrufen, nachdem sie ZwCreateTransactionManager oder ZwOpenTransactionManager aufgerufen hat.

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

NtRecoverTransactionManager und ZwRecoverTransactionManager sind zwei Versionen derselben Windows Native System Services-Routine.

Bei Aufrufen von Kernelmodustreibern können sich die NtXxx - und ZwXxx-Versionen einer Windows Native System Services-Routine anders verhalten, da sie Eingabeparameter verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Nt Xxx- und ZwXxx-Versionen einer Routine finden Sie unter Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Betriebssystemversionen.
Zielplattform	Universell
Header	wdm.h (include Wdm.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Weitere Informationen

TmRecoverTransactionManager

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

ZwCreateTransactionManager

ZwOpenTransactionManager

ZwRollforwardTransactionManager