NtQueryInformationByName-Funktion (ntifs.h)

Artikel
02/26/2024

NtQueryInformationByName gibt die angeforderten Informationen zu einer Datei zurück, die durch den Dateinamen angegeben wird.

Syntax

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

Parameter

[in] ObjectAttributes

Zeiger auf eine OBJECT_ATTRIBUTES Struktur, die die Attribute der Datei enthält, einschließlich des Dateinamens.

[out] IoStatusBlock

Zeiger auf eine IO_STATUS_BLOCK-Struktur, die die E/A-status des Aufrufers enthält.

[out] FileInformation

Zeiger auf den vom Aufrufer bereitgestellten Puffer, in dem die angeforderten Informationen zur Datei zurückgegeben werden sollen. Die Struktur des Puffers wird durch den FileInformationClass-Parameter bestimmt.

[in] Length

Länge des Puffers, auf den FileInformation verweist, in Byte.

[in] FileInformationClass

Ein FILE_INFORMATION_CLASS Wert, der den Typ der Dateiinformationen angibt, die im Puffer zurückgegeben werden sollen, auf den FileInformation verweist. FileInformationClass kann einer der folgenden Werte sein.

FILE_INFORMATION_CLASS-Wert	Typ der zurückzugebenden Informationen
FileStatInformation (68)	FILE_STAT_INFORMATION. Verfügbar ab Windows 10 Version 1709.
FileStatLxInformation (70)	FILE_STAT_LX_INFORMATION. Verfügbar ab Windows 10 Update vom April 2018.
FileCaseSensitiveInformation (71)	FILE_CASE_SENSITIVE_INFORMATION. Verfügbar ab Windows 10 Update vom April 2018.
FileStatBasicInformation (77)	FILE_STAT_BASIC_INFORMATION. Verfügbar ab Windows 11, Build 26048.

Rückgabewert

NtQueryInformationByName gibt nach erfolgreichem Abschluss STATUS_SUCCESS zurück. Andernfalls wird ein Fehlercode zurückgegeben, z. B. einer der folgenden.

Fehlercode	Bedeutung
STATUS_INVALID_PARAMETER	Der Parameter FileInformationClass enthält einen ungültigen Wert.
STATUS_INFO_LENGTH_MISMATCH	Die durch Länge angegebene Puffergröße ist nicht groß genug, um die angeforderten Informationen zu enthalten.

Hinweise

NtQueryInformationByName fragt die angeforderten Informationen zur Datei ab und gibt diese zurück. Dies geschieht, ohne die eigentliche Datei zu öffnen, was sie effizienter als NtQueryInformationFile macht, was eine Datei öffnen (und nachfolgende Datei schließen) erfordert.

Aufrufer von NtQueryInformationByName müssen unter IRQL = PASSIVE_LEVEL und mit aktivierten speziellen Kernel-APCs ausgeführt werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1703
Kopfzeile	ntifs.h
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL (siehe Abschnitt "Hinweise")