Funzione NtQueryInformationByName (ntifs.h)

Articolo
02/07/2024

NtQueryInformationByName restituisce le informazioni richieste su un file specificato dal nome del file.

Sintassi

__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
);

Parametri

[in] ObjectAttributes

Puntatore a una struttura OBJECT_ATTRIBUTES contenente gli attributi del file, incluso il nome del file.

[out] IoStatusBlock

Puntatore una struttura IO_STATUS_BLOCK contenente lo stato di I/O del chiamante.

[out] FileInformation

Puntatore al buffer fornito dal chiamante in cui restituire le informazioni richieste sul file. La struttura del buffer è determinata dal parametro FileInformationClass .

[in] Length

Lunghezza, in byte, del buffer a cui Punta FileInformation .

[in] FileInformationClass

Valore FILE_INFORMATION_CLASS che identifica il tipo di informazioni sui file da restituire nel buffer a cui punta FileInformation . FileInformationClass può essere uno dei valori seguenti.

valore FILE_INFORMATION_CLASS	Tipo di informazioni da restituire
FileStatInformation (68)	FILE_STAT_INFORMATION. Disponibile a partire da Windows 10 versione 1709.
FileStatLxInformation (70)	FILE_STAT_LX_INFORMATION. Disponibile a partire da Windows 10 aggiornamento di aprile 2018.
FileCaseSensitiveInformation (71)	FILE_CASE_SENSITIVE_INFORMATION. Disponibile a partire da Windows 10 aggiornamento di aprile 2018.
FileStatBasicInformation (77)	FILE_STAT_BASIC_INFORMATION. Disponibile a partire da Windows 11, build 26048.

Valore restituito

NtQueryInformationByName restituisce STATUS_SUCCESS al completamento positivo; in caso contrario, restituisce un codice di errore, ad esempio uno dei seguenti.

Codice di errore	Significato
STATUS_INVALID_PARAMETER	Il parametro FileInformationClass contiene un valore non valido.
STATUS_INFO_LENGTH_MISMATCH	Le dimensioni del buffer specificate da Length non sono sufficienti per contenere le informazioni richieste.

Commenti

Query NtQueryInformationByName e restituisce le informazioni richieste sul file. Lo fa senza aprire il file effettivo, rendendolo più efficiente di NtQueryInformationFile, che richiede un file aperto (e una chiusura del file successiva).

I chiamanti di NtQueryInformationByName devono essere eseguiti in IRQL = PASSIVE_LEVEL e con API kernel speciali abilitate.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 versione 1703
Intestazione	ntifs.h
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL (vedere la sezione Osservazioni)