NtRecoverResourceManager-Funktion (wdm.h)
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 |
|---|---|
|
Das angegebene Handle ist kein Handle für ein Resource Manager-Objekt. |
|
Ein Objekthandle ist ungültig. |
|
Der Transaktions-Manager, der dem angegebenen Ressourcen-Manager zugeordnet ist, ist nicht verfügbar. |
|
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 |
Weitere Informationen
Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen