ZwSetEaFile-Funktion (ntifs.h)

Artikel
12/21/2024

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

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 Abschlussstatus 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.

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 Puffer verweist, ist nicht ordnungsgemäß formatiert. 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.

Bemerkungen

ZwSetEaFile ersetzt die mit FileHandle- verknüpften EAs durch die EAs im Puffer, auf die Buffer verweist. Die EAs im Puffer müssen als Sequenz von FILE_FULL_EA_INFORMATION Strukturen formatiert werden. ZwSetEaFile zuerst überprüft, ob der Puffer von EA-Werten gültig ist, bevor die vorhandenen EAs ersetzt werden.

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

IoCheckEaBufferValidity-

ZwQueryEaFile-

Freigeben über