NtRecoverTransactionManager-Funktion (wdm.h)

Artikel
07.02.2025

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

Syntax

C++

__kernel_entry NTSYSCALLAPI NTSTATUS NtRecoverTransactionManager(
  [in] HANDLE TransactionManagerHandle
);

Parameter

[in] TransactionManagerHandle

Ein Handle für ein Transaktions-Manager-Objekt, das durch einen vorherigen Aufruf von ZwCreateTransactionManager oder ZwOpenTransactionManagerabgerufen wurde. Das Handle muss über TRANSACTIONMANAGER_RECOVER Zugriff auf das Objekt verfügen.

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 geeigneten Zugriff auf das Transaktions-Manager-Objekt.
STATUS_TM_VOLATILE	Das Transaktions-Manager-Objekt ist veränderlich und kann daher nicht wiederhergestellt werden.
STATUS_UNSUCCESSFUL	Das Transaktions-Manager-Objekt befindet sich nicht in einem Zustand, der die Wiederherstellung zulässt.

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

Bemerkungen

Die ZwRecoverTransactionManager Routine versucht, den Status des Transaktions-Manager-Objekts zu rekonstruieren, einschließlich aller Transaktionen, Listen und Ressourcenmanager, aus den Wiederherstellungsinformationen, die sich im Protokolldatenstrom des Objekts befinden, beginnend am letzten Neustartbereich, dass KTM am Ende des Datenstroms erstellt und endet.

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

Ihre TPS-Komponente muss ZwRecoverTransactionManager aufrufen, nachdem sie ZwCreateTransactionManager oder ZwOpenTransactionManageraufgerufen 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, wie sie Eingabeparameter behandeln und interpretieren. Weitere Informationen zur Beziehung zwischen den NtXxx und ZwXxx- Versionen einer Routine finden Sie unter Using Nt and Zw Versions of the Native System Services 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, Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	PASSIVE_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs, PowerIrpDDis