ZwQueryEaFile-Funktion (ntifs.h)
Die ZwQueryEaFile-Routine gibt die erweiterten Attribute (EAs) zurück, die der angegebenen Datei zugeordnet sind.
Syntax
NTSTATUS ZwQueryEaFile(
[in] HANDLE FileHandle,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[out] PVOID Buffer,
[in] ULONG Length,
[in] BOOLEAN ReturnSingleEntry,
[in, optional] PVOID EaList,
[in] ULONG EaListLength,
[in, optional] PULONG EaIndex,
[in] BOOLEAN RestartScan
);
Parameter
[in] FileHandle
Das Handle für die Datei, für die der Vorgang ausgeführt werden soll.
[out] IoStatusBlock
Ein Zeiger auf eine IO_STATUS_BLOCK-Struktur, die die endgültige Vervollständigung status und andere Informationen zum angeforderten Vorgang empfängt.
[out] Buffer
Ein Zeiger auf einen vom Aufrufer bereitgestellten FILE_FULL_EA_INFORMATION strukturierten Ausgabepuffer, in dem die EAs der Datei zurückgegeben werden sollen.
[in] Length
Die Länge des Puffers in Bytes, auf den Puffer verweist.
[in] ReturnSingleEntry
Legen Sie auf TRUE fest, wenn ZwQueryEaFile nur den ersten gefundenen Eintrag zurückgeben soll.
[in, optional] EaList
Ein Zeiger auf einen vom Aufrufer bereitgestellten FILE_GET_EA_INFORMATION strukturierten Eingabepuffer, der die abzufragten EAs angibt. Dieser Parameter ist optional und kann NULL sein.
[in] EaListLength
Die Länge des Puffers in Bytes, auf den der EaList-Parameter verweist.
[in, optional] EaIndex
Der Index des Eintrags, mit dem die Überprüfung der EA-Liste der Datei beginnen soll. Dieser Parameter wird ignoriert, wenn EaList auf eine nicht erlösende Liste verweist. Dieser Parameter ist optional und kann NULL sein.
[in] RestartScan
Legen Sie auf TRUE fest, wenn ZwQueryEaFile die Überprüfung am ersten Eintrag in der EA-Liste der Datei beginnen soll. Wenn dieser Parameter auf FALSE festgelegt ist, setzt die Routine den Scan von einem vorherigen Aufruf von ZwQueryEaFile fort.
Rückgabewert
ZwQueryEaFile gibt STATUS_SUCCESS oder einen entsprechenden NTSTATUS-Wert wie den folgenden zurück:
| Rückgabewert | BESCHREIBUNG |
|---|---|
| STATUS_EAS_NOT_SUPPORTED | Das Dateisystem unterstützt keine EAs. Dies ist ein Fehlercode. |
| STATUS_INSUFFICIENT_RESOURCES | Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen. Dies ist ein Fehlercode. |
| STATUS_EA_LIST_INCONSISTENT | Der EaList-Parameter ist nicht ordnungsgemäß formatiert. Dies ist ein Fehlercode. |
Hinweise
Die Menge an Informationen, die ZwQueryEaFile zurückgibt, basiert auf der Größe der EAs und der Größe des Puffers , auf den Buffer verweist. Das heißt, entweder werden alle angeforderten EAs in den Puffer geschrieben, oder der Puffer wird mit so vielen vollständigen EAs gefüllt, wenn er nicht groß genug ist, um alle EAs zu enthalten. Nur vollständige EAs werden in den Puffer geschrieben. es werden keine teilweisen EAs zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 |
| Zielplattform | Universell |
| Header | ntifs.h (include FltKernel.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |