NtRecoverResourceManager-Funktion (wdm.h)

Artikel
02/29/2024

Die ZwRecoverResourceManager-Routine versucht, die Transaktion wiederherzustellen, die jeder Eintragung eines angegebenen Resource Manager-Objekts zugeordnet ist.

Syntax

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

Parameter

[in] ResourceManagerHandle

Ein Handle für ein Resource Manager-Objekt, das durch einen vorherigen Aufruf von ZwCreateResourceManager oder ZwOpenResourceManager abgerufen 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 Resource 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 Resource Manager-Objekt.

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

Hinweise

Wenn ein Ressourcen-Manager ZwRecoverResourceManager aufruft, sendet KTM eine TRANSACTION_NOTIFY_RECOVER Benachrichtigung an den Ressourcen-Manager für jede Der Eintrage des Ressourcen-Managers. (Wenn es sich bei der Aufnahme um eine überlegene Einlistung handelt, sendet KTM TRANSACTION_NOTIFY_RECOVER_QUERY anstelle von TRANSACTION_NOTIFY_RECOVER.)

Die endgültige Benachrichtigung, die KTM an den Ressourcen-Manager sendet, ist TRANSACTION_NOTIFY_LAST_RECOVER.

Weitere Informationen zu ZwRecoverResourceManager finden 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 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 systemeigenen 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