FltQueryInformationByName-Funktion (fltkernel.h)

Artikel
02/06/2025

Die FltQueryInformationByName Routine gibt die angeforderten Informationen zu einer benannten Datei zurück.

Syntax

NTSTATUS FLTAPI FltQueryInformationByName(
  [in]           PFLT_FILTER               Filter,
  [in, optional] PFLT_INSTANCE             Instance,
  [in]           POBJECT_ATTRIBUTES        ObjectAttributes,
  [out]          PIO_STATUS_BLOCK          IoStatusBlock,
  [out]          PVOID                     FileInformation,
  [in]           ULONG                     Length,
  [in]           FILE_INFORMATION_CLASS    FileInformationClass,
  [in, optional] PIO_DRIVER_CREATE_CONTEXT DriverContext
);

Parameter

[in] Filter

Gibt den Filter an, der diesen Vorgang initiiert.

[in, optional] Instance

Gibt die Instanz an, auf die die Erstellung ausgerichtet ist.

Wichtig

Instanz ist nicht unbedingt die initiierende Instanz. Sie muss mit der Instanz übereinstimmen, auf die die Erstellung ausgerichtet ist, wenn dieser Parameter nichtNULL-ist. Wenn Instanz- nichtNULL-ist, wird der Vorerstellungsrückruf des aktuellen Filters nicht aufgerufen. Die Rückrufe beginnen mit dem Filter unterhalb des aktuellen Filters.

[in] ObjectAttributes

Zeigen Sie auf eine [OBJECT_ATTRIBUTES] -Struktur mit den Attributen, die für das Dateiobjekt verwendet werden sollen (z. B. name, SECURITY_DESCRIPTOR usw.).

[out] IoStatusBlock

Zeigen Sie auf eine IO_STATUS_BLOCK Struktur, die den E/A-Statusblock des Aufrufers enthält.

[out] FileInformation

Zeigen Sie auf eine Struktur, die die angeforderten Informationen empfängt, die über die Datei zurückgegeben werden. Der Strukturtyp wird durch FileInformationClassbestimmt.

[in] Length

Die Länge des FileInformation- Puffers in Bytes.

[in] FileInformationClass

Ein FILE_INFORMATION_CLASS Enumerationswert, der den Typ der Informationen angibt, die über die Datei zurückgegeben werden sollen. Dies kann einer der folgenden Werte sein:

Wert	Typ der Struktur, auf die FileInformation verweist
FileStatInformation	FILE_STAT_INFORMATION
FileStatLxInformation	**FILE_STAT_LX_INFORMATION
FileCaseSensitiveInformation	FILE_CASE_SENSITIVE_INFORMATION. Der Aufrufer muss die Datei mit dem im Parameter DesiredAccess angegebenen FILE_READ_ATTRIBUTES Flag geöffnet haben. Dieser Wert ist ab Windows 10, Version 1803, verfügbar.
FileCaseSensitiveInformationForceAccessCheck	FILE_CASE_SENSITIVE_INFORMATION. Dies ist eine spezielle Version des FileCaseSensitiveInformation-Vorgangs, der verwendet wird, um zu erzwingen, dass der IO-Manager Zugriffsprüfungen für den Kernelmodustreiber durchführt, ähnlich wie die Prüfungen, die für einen Benutzermodus-Aufrufer gelten. Dieser Vorgang wird nur vom IO-Manager erkannt, und ein Dateisystem sollte ihn nie empfangen. Dieser Wert ist ab Windows 10, Version 1803, verfügbar.

[in, optional] DriverContext

Ein Zeiger auf den Kontextbereich des Treibers.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.

Bemerkungen

Diese Funktion gibt angeforderte Informationen zu einer Datei zurück, ohne die eigentliche Datei zu öffnen. Die zurückgegebenen Informationen werden durch die angegebene FileInformationClass- bestimmt und in den FileInformation Puffer des Aufrufers eingefügt.

Wenn Instance- nichtNULL- ist, wird die Erstellung auf die angegebene Instanz ausgerichtet, wobei alle Filter unterhalb des aktuellen Filters aufgerufen werden, bevor die E/A-Nachricht nach unten gesendet wird. Wenn Instanz-NULL-ist, wird die E/A immer an den Anfang des Filterstapels gesendet.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 1706
Header-	fltkernel.h
Library	FltMgr.lib
DLL-	Fltmgr.sys

Siehe auch

FILE_INFORMATION_CLASS

Freigeben über