Funzione NtOpenResourceManager (wdm.h)

Articolo
02/07/2025

La routine ZwOpenResourceManager restituisce un handle a un oggetto resource manager esistente .

Sintassi

__kernel_entry NTSYSCALLAPI NTSTATUS NtOpenResourceManager(
  [out]          PHANDLE            ResourceManagerHandle,
  [in]           ACCESS_MASK        DesiredAccess,
  [in]           HANDLE             TmHandle,
  [in]           LPGUID             ResourceManagerGuid,
  [in, optional] POBJECT_ATTRIBUTES ObjectAttributes
);

Parametri

[out] ResourceManagerHandle

Puntatore a una variabile allocata dal chiamante che riceve l'handle di Resource Manager se la chiamata a ZwOpenResourceManager ha esito positivo.

[in] DesiredAccess

Valore ACCESS_MASK che specifica l'accesso richiesto dal chiamante all'oggetto resource manager. Per altre informazioni su come specificare questo parametro, vedere il parametro DesiredAccess di ZwCreateResourceManager. Questo parametro non può essere zero.

[in] TmHandle

Handle per un oggetto di gestione transazioni ottenuto da una chiamata precedente a ZwCreateTransactionManager o ZwOpenTransactionManager.

[in] ResourceManagerGuid

Puntatore al GUID che identifica il gestore risorse da aprire.

[in, optional] ObjectAttributes

Puntatore a una struttura OBJECT_ATTRIBUTES che specifica gli attributi dell'oggetto. Utilizzare la routine InitializeObjectAttributes per inizializzare questa struttura, ma specificare solo il InitializedAttributes e attributi parametri della routine. Se il chiamante non è in esecuzione in un contesto di thread di sistema, deve impostare il flag OBJ_KERNEL_HANDLE nel parametro Attributi. Questo parametro è facoltativo e può essere NULL.

Valore restituito

ZwOpenResourceManager 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 che TmHandle specifica non è un handle per un oggetto transazione.
STATUS_INVALID_HANDLE	L'handle che TmHandle specifica non è valido.
STATUS_ACCESS_DENIED	Il chiamante non dispone dell'accesso appropriato all'oggetto di gestione transazioni specificato.
STATUS_INVALID_PARAMETER	Il parametro DesiredAccess è zero o il parametro ResourceManagerGuid non è valido.
STATUS_RESOURCEMANAGER_NOT_FOUND	Impossibile trovare il gestore risorse specificato.
STATUS_TRANSACTIONMANAGER_NOT_ONLINE	Il gestore transazioni specificato non è online.

La routine potrebbe restituire altri valori NTSTATUS .

Osservazioni

In genere, un componente TPS chiama ZwOpenResourceManager dopo aver ricevuto un GUID di integrazione da un altro componente TPS precedentemente chiamato ZwCreateResourceManager. La maggior parte delle progettazioni TPS non richiede la chiamata ZwOpenResourceManager.

Un gestore di risorse che chiama ZwOpenResourceManager deve chiamare ZwClose per chiudere l'handle dell'oggetto.

Per altre informazioni su ZwOpenResourceManager, vedere oggetti KTM.

NtOpenResourceManager e ZwOpenResourceManager sono due versioni della stessa routine di Servizi di sistema nativi di Windows.

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
regole di conformità DDI	HwStorPortProhibitedDDIs, PowerIrpDDis