Función ZwQueryObject (ntifs.h)

La rutina ZwQueryObject proporciona información sobre un objeto proporcionado.

Sintaxis

NTSYSAPI NTSTATUS ZwQueryObject(
  [in, optional]  HANDLE                   Handle,
  [in]            OBJECT_INFORMATION_CLASS ObjectInformationClass,
  [out, optional] PVOID                    ObjectInformation,
  [in]            ULONG                    ObjectInformationLength,
  [out, optional] PULONG                   ReturnLength
);

Parámetros

[in, optional] Handle

Identificador del objeto para obtener información sobre.

[in] ObjectInformationClass

Especifica un valor OBJECT_INFORMATION_CLASS que determina el tipo de información devuelta en el búfer de ObjectInformation.

[out, optional] ObjectInformation

Puntero a un búfer asignado por el autor de la llamada que recibe la información solicitada.

[in] ObjectInformationLength

Especifica el tamaño, en bytes, del búfer de ObjectInformation.

[out, optional] ReturnLength

Puntero a una variable que recibe el tamaño, en bytes, de la información de clave solicitada. Si ZwQueryObject devuelve STATUS_SUCCESS, la variable contiene la cantidad de datos devueltos. Si ZwQueryObject devuelve STATUS_BUFFER_OVERFLOW o STATUS_BUFFER_TOO_SMALL, puede usar el valor de la variable para determinar el tamaño de búfer necesario.

Valor devuelto

ZwQueryObject devuelve STATUS_SUCCESS o un estado de error adecuado. Entre los códigos de estado de error posibles se incluyen los siguientes:

Código devuelto	Descripción
STATUS_ACCESS_DENIED	No había permisos suficientes para realizar esta consulta.
STATUS_INVALID_HANDLE	El identificador de objeto proporcionado no es válido.
STATUS_INFO_LENGTH_MISMATCH	La longitud de la información no es suficiente para contener los datos.

Observaciones

Si la llamada a la función ZwQueryObject de se produce en modo de usuario, debe usar el nombre "NtQueryObject" en lugar de "ZwQueryObject".

En el caso de las llamadas desde controladores en modo kernel, las NtXxx y Zwversiones de Xxx de una rutina de Servicios del sistema nativo de Windows pueden comportarse 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 de NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000.
de la plataforma de destino de	Universal
encabezado de	ntifs.h (incluya Ntifs.h, FltKernel.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	PASSIVE_LEVEL
reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Consulte también

OBJECT_INFORMATION_CLASS

PUBLIC_OBJECT_BASIC_INFORMATION

PUBLIC_OBJECT_TYPE_INFORMATION

usar versiones Nt y Zw de las rutinas de servicios del sistema nativo