Funzione NtRecoverResourceManager (wdm.h)

Articolo
02/27/2024

La routine ZwRecoverResourceManager tenta di recuperare la transazione associata a ogni integrazione di un oggetto resource manager specificato.

Sintassi

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

Parametri

[in] ResourceManagerHandle

Handle per un oggetto resource manager ottenuto da una chiamata precedente a ZwCreateResourceManager o ZwOpenResourceManager. L'handle deve avere RESOURCEMANAGER_RECOVER accesso all'oggetto .

Valore restituito

ZwRecoverResourceManager restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa routine potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_OBJECT_TYPE_MISMATCH	L'handle specificato non è un handle per un oggetto resource manager.
STATUS_INVALID_HANDLE	Un handle di oggetto non è valido.
STATUS_TRANSACTIONMANAGER_NOT_ONLINE	Gestione transazioni associato al gestore risorse specificato non è disponibile.
STATUS_ACCESS_DENIED	Il chiamante non dispone dell'accesso appropriato all'oggetto resource manager.

La routine potrebbe restituire altri valori NTSTATUS.

Commenti

Quando un gestore di risorse chiama ZwRecoverResourceManager, KTM invia una notifica di TRANSACTION_NOTIFY_RECOVER al gestore risorse per ogni integrazione del gestore risorse. Se l'integrazione è un'integrazione superiore, KTM invia TRANSACTION_NOTIFY_RECOVER_QUERY anziché TRANSACTION_NOTIFY_RECOVER.

La notifica finale inviata da KTM al gestore risorse è TRANSACTION_NOTIFY_LAST_RECOVER.

Per altre informazioni su ZwRecoverResourceManager, vedere Gestione delle operazioni di ripristino.

NtRecoverResourceManager e ZwRecoverResourceManager sono due versioni della stessa routine di Servizi di sistema nativi di Windows.

Per le chiamate da driver in modalità kernel, le versioni NtXxx e ZwXxx di una routine di Servizi di sistema nativi di Windows possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Using Nt and Zw Versions of the Native System Services Routines .For more information about the Nt Xxx and Zw versions of the Native System Services Routines.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive del sistema operativo.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL