ZwSetEaFile-Funktion (ntifs.h)

ZwSetEaFile ersetzt die erweiterten Attribute (EAs), die einer Datei zugeordnet sind, durch die angegebenen EAs.

Syntax

NTSTATUS ZwSetEaFile(
  [in]  HANDLE           FileHandle,
  [out] PIO_STATUS_BLOCK IoStatusBlock,
  [in]  PVOID            Buffer,
  [in]  ULONG            Length
);

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 Abschluss status und andere Informationen zum angeforderten Vorgang empfängt.

[in] Buffer

Ein Zeiger auf einen vom Aufrufer bereitgestellten FILE_FULL_EA_INFORMATION strukturierten Eingabepuffer, der die neuen EAs enthält, die die derzeit der Datei zugeordneten EAs ersetzen.

[in] Length

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

Rückgabewert

ZwSetEaFile gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert wie den folgenden zurück:

Rückgabewert	BESCHREIBUNG
STATUS_EA_LIST_INCONSISTENT	Die EA-Liste, auf die Buffer zeigt, ist nicht ordnungsgemäß formatiert. Dies ist ein Fehlercode.
STATUS_INSUFFICIENT_RESOURCES	Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen. Dies ist ein Fehlercode.

Hinweise

ZwSetEaFile ersetzt die EAs, die FileHandle zugeordnet sind, durch die EAs im Puffer, auf den Buffer verweist. Die EAs im Puffer müssen als Sequenz von FILE_FULL_EA_INFORMATION Strukturen formatiert werden. ZwSetEaFile überprüft zunächst , ob der Puffer der EA-Werte gültig ist , bevor die vorhandenen EAs ersetzt werden.

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	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Weitere Informationen

FILE_FULL_EA_INFORMATION

IoCheckEaBufferValidity

ZwQueryEaFile