ZwQueryInformationByName-Funktion (wdm.h)

Artikel
02/27/2024

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

Syntax

NTSYSAPI NTSTATUS ZwQueryInformationByName(
  [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.

Rückgabewert

ZwQueryInformationByName 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

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

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