Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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) |