Freigeben über


NtRecoverResourceManager-Funktion (wdm.h)

Die ZwRecoverResourceManager Routine versucht, die Transaktion wiederherzustellen, die jeder Liste eines angegebenen Ressourcen-Manager-Objektszugeordnet ist.

Syntax

__kernel_entry NTSYSCALLAPI NTSTATUS NtRecoverResourceManager(
  [in] HANDLE ResourceManagerHandle
);

Parameter

[in] ResourceManagerHandle

Ein Handle zu einem Ressourcen-Manager-Objekt, das durch einen vorherigen Aufruf von ZwCreateResourceManager oder ZwOpenResourceManagerabgerufen wurde. Das Handle muss über RESOURCEMANAGER_RECOVER Zugriff auf das Objekt verfügen.

Rückgabewert

ZwRecoverResourceManager 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 Ressourcen-Manager-Objekt.
STATUS_INVALID_HANDLE
Ein Objekthandle ist ungültig.
STATUS_TRANSACTIONMANAGER_NOT_ONLINE
Der Transaktions-Manager, der dem angegebenen Ressourcen-Manager zugeordnet ist, ist nicht verfügbar.
STATUS_ACCESS_DENIED
Der Aufrufer hat keinen geeigneten Zugriff auf das Ressourcen-Manager-Objekt.
 

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

Bemerkungen

Wenn ein Ressourcenmanager ZwRecoverResourceManageraufruft, sendet KTM eine TRANSACTION_NOTIFY_RECOVER Benachrichtigung an den Ressourcenmanager für die einzelnen Ressourcenlisten des Ressourcenmanagers. (Wenn es sich bei der Einlistung um eine überlegene Einlistung handelt, sendet KTM TRANSACTION_NOTIFY_RECOVER_QUERY anstelle von TRANSACTION_NOTIFY_RECOVER.)

Die endgültige Benachrichtigung, dass KTM an den Ressourcenmanager sendet, ist TRANSACTION_NOTIFY_LAST_RECOVER.

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

NtRecoverResourceManager und ZwRecoverResourceManager 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

Siehe auch

TmRecoverResourceManager-

Verwenden von Nt- und Zw-Versionen der systemeigenen Systemdienste-Routinen

ZwCreateResourceManager

ZwOpenResourceManager

ZwQueryInformationResourceManager

ZwSetInformationResourceManager