Función NtQueryInformationByName (ntifs.h)

Artículo
02/07/2024

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

Sintaxis

__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryInformationByName(
  [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 valores siguientes.

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.
FileStatBasicInformation (77)	FILE_STAT_BASIC_INFORMATION. Disponible a partir de Windows 11, compilación 26048.

Valor devuelto

NtQueryInformationByName devuelve STATUS_SUCCESS tras la finalización correcta; 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

NtQueryInformationByName 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 NtQueryInformationFile, que requiere un archivo abierto (y cierre de archivo posterior).

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1703
Encabezado	ntifs.h
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL (consulte la sección Comentarios)