Función NtQueryObject (ntifs.h)
La rutina NtQueryObject proporciona información sobre un objeto proporcionado.
Sintaxis
__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryObject(
[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 de OBJECT_INFORMATION_CLASS que determina el tipo de información devuelta en el búfer 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 ObjectInformation .
[out, optional] ReturnLength
Puntero a una variable que recibe el tamaño, en bytes, de la información de clave solicitada. Si NtQueryObject devuelve STATUS_SUCCESS, la variable contiene la cantidad de datos devueltos. Si NtQueryObject 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
NtQueryObject devuelve STATUS_SUCCESS o un estado de error adecuado. Entre los posibles códigos de estado de error 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. |
Comentarios
Si la llamada a la función NtQueryObject 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 versiones NtXxx y ZwXxx de una rutina de Windows Native System Services 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 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 | Windows 2000. |
| Plataforma de destino | Universal |
| Encabezado | ntifs.h (incluya Ntifs.h, FltKernel.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDIs, PowerIrpDDis |