Funzione NtRecoverResourceManager (wdm.h)

Articolo
02/07/2025

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 .

Osservazioni

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 Windows Native System Services.

Per le chiamate da driver in modalità kernel, le NtXxx e ZwXxx versioni di una routine di Windows Native System Services 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.

Fabbisogno

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