ZwQueryEaFile-Funktion (ntifs.h)

  • Artikel

Die ZwQueryEaFile-Routine gibt Informationen zu EA-Werten (Extended-Attribute) für eine Datei zurück.

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 erweiterten Attributwerte zurückgegeben werden sollen.

[in] Length

Die Länge des Puffers in Bytes, auf den der Buffer-Parameter 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 zu abfragenden erweiterten Attribute 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 Liste der erweiterten Attribute der Datei beginnen soll. Dieser Parameter wird ignoriert, wenn der EaList-Parameter 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 Liste der erweiterten Attribute 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 erweiterten Attribute. Dies ist ein Fehlercode.
STATUS_INSUFFICIENT_RESOURCES
 Bei der ZwQueryEaFile-Routine ist ein Poolzuordnungsfehler aufgetreten. Dies ist ein Fehlercode.
STATUS_EA_LIST_INCONSISTENT
 Der EaList-Parameter ist nicht ordnungsgemäß formatiert. Dies ist ein Fehlercode.

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