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) |