ZwQueryEaFile-Funktion (ntifs.h)

Artikel
12/21/2024

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 den endgültigen Abschlussstatus 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 Buffer verweist.

[in] ReturnSingleEntry

Wird auf TRUE festgelegt, 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 zu abfragenden EAs angibt. Dieser Parameter ist optional und kann NULL sein.

[in] EaListLength

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

[in, optional] EaIndex

Der Index des Eintrags, bei dem die EA-Liste der Datei gescannt werden soll. Dieser Parameter wird ignoriert, wenn EaList- auf eine nicht leere Liste verweist. Dieser Parameter ist optional und kann NULL sein.

[in] RestartScan

Auf TRUE festgelegt, wenn ZwQueryEaFile- die Überprüfung beim 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 ZwQueryEaFilefort.

Rückgabewert

ZwQueryEaFile- gibt STATUS_SUCCESS oder einen geeigneten 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 steht nicht genügend Arbeitsspeicher zur Verfügung, um den Vorgang abzuschließen. Dies ist ein Fehlercode.
STATUS_EA_LIST_INCONSISTENT	Der EaList--Parameter ist nicht ordnungsgemäß formatiert. Dies ist ein Fehlercode.

Bemerkungen

Die Menge der 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 alle angeforderten EAs werden in den Puffer geschrieben, oder der Puffer wird mit so vielen vollständigen EAs gefüllt, wenn es nicht groß genug ist, um alle EAs zu enthalten. Nur vollständige EAs werden in den Puffer geschrieben; es werden keine partiellen EAs jemals zurückgegeben.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000
Zielplattform-	Universal
Header-	ntifs.h (include FltKernel.h, Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	PASSIVE_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Siehe auch

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

ZwSetEaFile-

Freigeben über