ZwQueryEaFile-Funktion (ntifs.h)

Artikel
04/29/2024

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)

Weitere Informationen

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

ZwSetEaFile

Freigeben über