FltQueryEaFile-Funktion (fltkernel.h)

  • Artikel

FltQueryEaFile gibt 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 instance Zeiger für den Minifiltertreiber instance, an den der QueryEa-Vorgang gesendet werden soll. Die instance 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 in Bytes, auf den der Parameter ReturnedEaData verweist.

[in] ReturnSingleEntry

Legen Sie diesen Wert auf TRUE fest, 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 sein.

[in] EaListLength

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

[in, optional] EaIndex

Index des Eintrags, an 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 sein.

[in] RestartScan

Legen Sie diesen Wert auf TRUE fest, wenn FltQueryEaFile die Überprüfung am ersten Eintrag in der Liste der erweiterten Attribute der Datei beginnen soll. Wenn dieser Parameter nicht auf TRUE festgelegt ist, wird die Überprüfung von einem vorherigen Aufruf von FltQueryEaFile fortgesetzt.

[out, optional] LengthReturned

Zeiger 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 sein.

Rückgabewert

FltQueryEaFile gibt STATUS_SUCCESS oder einen entsprechenden 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 instance oder das Volume wird abgerissen. Dies ist ein Fehlercode.
STATUS_INSUFFICIENT_RESOURCES
 Bei FltQueryEaFile ist ein Poolzuordnungsfehler aufgetreten. Dies ist ein Fehlercode.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (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 Universell
Header fltkernel.h (fltkernel.h einschließen)
Bibliothek FltMgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

Weitere Informationen

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

FltSetEaFile

IoCheckEaBufferValidity