FltQueryEaFile-Funktion (fltkernel.h)

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:

Anforderungen

Siehe auch

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

FltSetEaFile-

IoCheckEaBufferValidity