Compartir a través de


Función NtQueryInformationResourceManager (wdm.h)

La rutina ZwQueryInformationResourceManager recupera información sobre un objeto de Resource Manager especificado.

Sintaxis

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

Parámetros

[in] ResourceManagerHandle

Identificador de un objeto de administrador de recursos obtenido por una llamada anterior a ZwCreateResourceManager o ZwOpenResourceManager. El identificador debe tener RESOURCEMANAGER_QUERY_INFORMATION acceso al objeto .

[in] ResourceManagerInformationClass

Valor con tipo RESOURCEMANAGER_INFORMATION_CLASS que especifica la información que se va a recuperar. Este valor debe ser ResourceManagerBasicInformation.

[out] ResourceManagerInformation

Puntero a una estructura de RESOURCEMANAGER_BASIC_INFORMATION asignada por el autor de la llamada que recibe información de ZwQueryInformationResourceManager.

[in] ResourceManagerInformationLength

Longitud, en bytes, del búfer al que apunta el parámetro ResourceManagerInformation .

[out, optional] ReturnLength

Puntero a una variable asignada por el autor de la llamada que recibe la longitud, en bytes, de la información que KTM escribe en el búfer ResourceManagerInformation . Este parámetro es opcional y puede ser NULL.

Valor devuelto

ZwQueryInformationResourceManager devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta rutina podría devolver uno de los siguientes valores:

Código devuelto Descripción
STATUS_OBJECT_TYPE_MISMATCH
El identificador especificado no es un identificador para un objeto de Resource Manager.
STATUS_INVALID_HANDLE
Un identificador de objeto no es válido.
STATUS_INVALID_INFO_CLASS
El valor del parámetro ResourceManagerInformationClass no es válido.
STATUS_BUFFER_TOO_SMALL
El tamaño del búfer que especifica el parámetro ResourceManagerInformationLength es menor que la estructura de RESOURCEMANAGER_BASIC_INFORMATION.
STATUS_BUFFER_OVERFLOW
El tamaño del búfer que especifica el parámetro ResourceManagerInformationLength es demasiado pequeño para recibir toda la información de longitud variable que está disponible.
STATUS_ACCESS_DENIED
El autor de la llamada no tiene el acceso adecuado al objeto de Resource Manager.
 

La rutina podría devolver otros valores NTSTATUS.

Comentarios

Para obtener más información sobre la rutina ZwQueryInformationResourceManager, consulte Creación de un Resource Manager.

NtQueryInformationResourceManager y ZwQueryInformationResourceManager son dos versiones de la misma rutina de Servicios del sistema nativo de Windows.

En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Servicios del sistema nativo de Windows se pueden comportar de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores del sistema operativo.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI HwStorPortProhibitedDIs, PowerIrpDDis

Consulte también

RESOURCEMANAGER_BASIC_INFORMATION

RESOURCEMANAGER_INFORMATION_CLASS

Uso de las versiones Nt y Zw de las rutinas nativas de Servicios del sistema

ZwCreateResourceManager

ZwOpenResourceManager

ZwRecoverResourceManager

ZwSetInformationResourceManager