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:
Rückgabecode | Beschreibung |
---|---|
|
Das Dateisystem unterstützt keine erweiterten Attribute. Dies ist ein Fehlercode. |
|
Die Instanz oder das Volume wird heruntergerissen. Dies ist ein Fehlercode. |
|
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 |