FltQueryEaFile-Funktion (fltkernel.h)

Artikel
02/06/2025

FltQueryEaFile Informationen zu EA-Werten (Extended-Attribute) für eine Datei zurück.

Syntax

NTSTATUS FLTAPI FltQueryEaFile(
  [in]            PFLT_INSTANCE Instance,
  [in]            PFILE_OBJECT  FileObject,
  [out]           PVOID         ReturnedEaData,
  [in]            ULONG         Length,
  [in]            BOOLEAN       ReturnSingleEntry,
  [in, optional]  PVOID         EaList,
  [in]            ULONG         EaListLength,
  [in, optional]  PULONG        EaIndex,
  [in]            BOOLEAN       RestartScan,
  [out, optional] PULONG        LengthReturned
);

Parameter

[in] Instance

Undurchsichtiger Instanzzeiger für die Minifiltertreiberinstanz, an die der QueryEa--Vorgang gesendet werden soll. Die Instanz muss an das Volume angefügt werden, auf dem sich die Datei befindet.

[in] FileObject

Dateiobjektzeiger für die Datei.

[out] ReturnedEaData

Zeiger auf einen vom Aufrufer bereitgestellten FILE_FULL_EA_INFORMATION-strukturierten Eingabepuffer, in dem die erweiterten Attributwerte zurückgegeben werden sollen.

[in] Length

Länge des Puffers, auf den der ReturnedEaData Parameter verweist.

[in] ReturnSingleEntry

Wird auf TRUE- festgelegt, wenn FltQueryEaFile- nur den ersten gefundenen Eintrag zurückgeben soll.

[in, optional] EaList

Zeiger auf einen vom Aufrufer bereitgestellten FILE_GET_EA_INFORMATION-strukturierten Eingabepuffer, der die erweiterten Attribute angibt, die abgefragt werden sollen. Dieser Parameter ist optional und kann NULL-werden.

[in] EaListLength

Länge des Puffers, auf den der EaList Parameter verweist.

[in, optional] EaIndex

Index des Eintrags, bei dem mit dem Scannen der Liste der erweiterten Attribute der Datei begonnen werden soll. Dieser Parameter wird ignoriert, wenn der EaList-Parameter auf eine nicht leere Liste verweist. Dieser Parameter ist optional und kann NULL-werden.

[in] RestartScan

Auf TRUE- festgelegt, wenn FltQueryEaFile- den Scan beim ersten Eintrag in der Erweitert-Attributliste der Datei beginnen soll. Wenn dieser Parameter nicht auf TRUEfestgelegt ist, wird der Scan aus einem vorherigen Aufruf von FltQueryEaFilefortgesetzt.

[out, optional] LengthReturned

Zeigen Sie auf eine vom Aufrufer zugewiesene Variable, die die Größe der im ReturnedEaData Puffer zurückgegebenen Informationen in Bytes empfängt. Dieser Parameter ist optional und kann NULL-werden.

Rückgabewert

FltQueryEaFile gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert wie den folgenden zurück:

Rückgabecode	Beschreibung
STATUS_EAS_NOT_SUPPORTED	Das Dateisystem unterstützt keine erweiterten Attribute. Dies ist ein Fehlercode.
STATUS_FLT_DELETING_OBJECT	Die Instanz oder das Volume wird heruntergerissen. Dies ist ein Fehlercode.
STATUS_INSUFFICIENT_RESOURCES	FltQueryEaFile ein Poolzuordnungsfehler aufgetreten. Dies ist ein Fehlercode.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Microsoft Windows 2000 UpdateRollup 1 für SP4, Windows XP SP3, Windows Server 2003 SP1 und höheren Versionen des Windows-Betriebssystems.
Zielplattform-	Universal
Header-	fltkernel.h (include Fltkernel.h)
Library	FltMgr.lib
DLL-	Fltmgr.sys
IRQL-	PASSIVE_LEVEL

Siehe auch

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

FltSetEaFile-

IoCheckEaBufferValidity

Freigeben über