FltQueryInformationByName-Funktion (fltkernel.h)

Artikel
08/07/2023

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 instance an, auf die die Erstellung ausgerichtet ist.

Wichtig

Die Instanz ist nicht unbedingt das initiierende instance. Er muss mit dem instance übereinstimmen, auf den die Erstellung ausgerichtet ist, wenn dieser Parameter nicht NULL ist. Wenn Die Instanz nicht NULL ist, wird der Vorerstellungsrückruf des aktuellen Filters nicht aufgerufen. Die Vorabrückrufe beginnen mit dem Filter unterhalb des aktuellen Filters.

[in] ObjectAttributes

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

[out] IoStatusBlock

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

[out] FileInformation

Zeiger auf eine Struktur, die die angeforderten Informationen empfängt, die zur Datei zurückgegeben werden. Der Typ der Struktur wird von FileInformationClass bestimmt.

[in] Length

Die Länge des FileInformation-Puffers in Bytes.

[in] FileInformationClass

Ein FILE_INFORMATION_CLASS Enumerationswert, der den Typ der Informationen angibt, die zur Datei zurückgegeben werden sollen. Folgenden Werte sind möglich:

Wert	Strukturtyp, auf den FileInformation verweist
FileStatInformation	FILE_STAT_INFORMATION
FileStatLxInformation	**FILE_STAT_LX_INFORMATION
FileCaseSensitiveInformation	FILE_CASE_SENSITIVE_INFORMATION. Der Aufrufer muss die Datei mit dem im DesiredAccess-Parameter 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 E/A-Manager Zugriffsprüfungen für den Kernelmodustreiber durchführt, ähnlich wie die Überprüfungen, die für einen Benutzermodusaufrufer gelten. Dieser Vorgang wird nur vom E/A-Manager erkannt und sollte nie von einem Dateisystem empfangen werden. 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.

Hinweise

Diese Funktion gibt angeforderte Informationen zu einer Datei zurück, ohne die tatsächliche Datei zu öffnen. Die zurückgegebenen Informationen werden durch die angegebene FileInformationClass bestimmt und im FileInformation-Puffer des Aufrufers platziert.

Wenn Die Instanz nicht NULL ist, wird die Erstellung auf den angegebenen instance ausgerichtet, wobei alle Filter unterhalb des aktuellen Filters aufgerufen werden, bevor die E/A-Vorgänge nach unten gesendet werden. Wenn InstanzNULL ist, wird die E/A immer an den Anfang des Filterstapels gesendet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1706
Kopfzeile	fltkernel.h
Bibliothek	FltMgr.lib
DLL	Fltmgr.sys

Weitere Informationen

FILE_INFORMATION_CLASS

Freigeben über