Condividi tramite


Funzione NtQueryInformationResourceManager (wdm.h)

La routine ZwQueryInformationResourceManager recupera informazioni su un oggetto resource manager specificato.

Sintassi

__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryInformationResourceManager(
  [in]            HANDLE                            ResourceManagerHandle,
  [in]            RESOURCEMANAGER_INFORMATION_CLASS ResourceManagerInformationClass,
  [out]           PVOID                             ResourceManagerInformation,
  [in]            ULONG                             ResourceManagerInformationLength,
  [out, optional] PULONG                            ReturnLength
);

Parametri

[in] ResourceManagerHandle

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

[in] ResourceManagerInformationClass

Valore tipizzato RESOURCEMANAGER_INFORMATION_CLASS che specifica le informazioni da recuperare. Questo valore deve essere ResourceManagerBasicInformation.

[out] ResourceManagerInformation

Puntatore a una struttura di RESOURCEMANAGER_BASIC_INFORMATION allocata dal chiamante che riceve informazioni da ZwQueryInformationResourceManager.

[in] ResourceManagerInformationLength

Lunghezza, in byte, del buffer a cui punta il parametro ResourceManagerInformation .

[out, optional] ReturnLength

Puntatore a una variabile allocata dal chiamante che riceve la lunghezza, in byte, delle informazioni che KTM scrive nel buffer ResourceManagerInformation . Questo parametro è facoltativo e può essere NULL.

Valore restituito

ZwQueryInformationResourceManager 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_INVALID_INFO_CLASS
Il valore del parametro ResourceManagerInformationClass non è valido.
STATUS_BUFFER_TOO_SMALL
Le dimensioni del buffer specificate dal parametro ResourceManagerInformationLength sono inferiori alla struttura RESOURCEMANAGER_BASIC_INFORMATION.
STATUS_BUFFER_OVERFLOW
Le dimensioni del buffer specificate dal parametro ResourceManagerInformationLength sono troppo piccole per ricevere tutte le informazioni a lunghezza variabile disponibili.
STATUS_ACCESS_DENIED
Il chiamante non dispone dell'accesso appropriato all'oggetto resource manager.
 

La routine potrebbe restituire altri valori NTSTATUS.

Commenti

Per altre informazioni sulla routine ZwQueryInformationResourceManager, vedere Creazione di un Resource Manager.

NtQueryInformationResourceManager e ZwQueryInformationResourceManager 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, Ntddk.h, Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regole di conformità DDI HwStorPortProhibitedDDIs, PowerIrpDDis

Vedi anche

RESOURCEMANAGER_BASIC_INFORMATION

RESOURCEMANAGER_INFORMATION_CLASS

Uso delle versioni Nt e Zw delle routine native di Servizi di sistema

ZwCreateResourceManager

ZwOpenResourceManager

ZwRecoverResourceManager

ZwSetInformationResourceManager