Función ZwQueryInformationByName (wdm.h)

Artículo
02/27/2024

ZwQueryInformationByName devuelve la información solicitada sobre un archivo especificado por nombre de archivo.

Sintaxis

NTSYSAPI NTSTATUS ZwQueryInformationByName(
  [in]  POBJECT_ATTRIBUTES     ObjectAttributes,
  [out] PIO_STATUS_BLOCK       IoStatusBlock,
  [out] PVOID                  FileInformation,
  [in]  ULONG                  Length,
  [in]  FILE_INFORMATION_CLASS FileInformationClass
);

Parámetros

[in] ObjectAttributes

Puntero a una estructura de OBJECT_ATTRIBUTES que contiene los atributos del archivo, incluido el nombre de archivo.

[out] IoStatusBlock

Puntero a una estructura de IO_STATUS_BLOCK que contiene el estado de E/S del autor de la llamada.

[out] FileInformation

Puntero al búfer proporcionado por el autor de la llamada en el que se va a devolver la información solicitada sobre el archivo. La estructura del búfer viene determinada por el parámetro FileInformationClass .

[in] Length

Longitud, en bytes, del búfer al que apunta FileInformation .

[in] FileInformationClass

Valor de FILE_INFORMATION_CLASS que identifica el tipo de información de archivo que se va a devolver en el búfer al que apunta FileInformation . FileInformationClass puede ser uno de los siguientes valores.

valor de FILE_INFORMATION_CLASS	Tipo de información que se va a devolver
FileStatInformation (68)	FILE_STAT_INFORMATION. Disponible a partir de Windows 10, versión 1709.
FileStatLxInformation (70)	FILE_STAT_LX_INFORMATION. Disponible a partir de Windows 10 actualización de abril de 2018.
FileCaseSensitiveInformation (71)	FILE_CASE_SENSITIVE_INFORMATION. Disponible a partir de Windows 10 actualización de abril de 2018.

Valor devuelto

ZwQueryInformationByName devuelve STATUS_SUCCESS tras completarse correctamente; de lo contrario, devuelve un código de error, como uno de los siguientes.

Código de error	Significado
STATUS_INVALID_PARAMETER	El parámetro FileInformationClass contiene un valor no válido.
STATUS_INFO_LENGTH_MISMATCH	El tamaño del búfer especificado por Length no es lo suficientemente grande como para contener la información solicitada.

Comentarios

ZwQueryInformationByName consulta y devuelve la información solicitada sobre el archivo. Lo hace sin abrir el archivo real, lo que hace que sea más eficaz que ZwQueryInformationFile, que requiere una apertura de archivo (y cierre de archivo posterior).

Los autores de llamadas de ZwQueryInformationByName deben ejecutarse en IRQL = PASSIVE_LEVEL y con las API de kernel especiales habilitadas.