Funzione ZwSetEaFile (ntifs.h)
ZwSetEaFile sostituisce gli attributi estesi (EAs) associati a un file con gli EA specificati.
Sintassi
NTSTATUS ZwSetEaFile(
[in] HANDLE FileHandle,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[in] PVOID Buffer,
[in] ULONG Length
);
Parametri
[in] FileHandle
Handle per il file in cui eseguire l'operazione.
[out] IoStatusBlock
Puntatore a una struttura IO_STATUS_BLOCK che riceve lo stato di completamento finale e altre informazioni sull'operazione richiesta.
[in] Buffer
Puntatore a un chiamante fornito FILE_FULL_EA_INFORMATION buffer di input strutturato che contiene i nuovi EAs che sostituiranno attualmente IAs associati al file.
[in] Length
Lunghezza, in byte, del buffer a cui punta il parametro Buffer .
Valore restituito
ZwSetEaFile restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio quanto segue:
| Valore restituito | Descrizione |
|---|---|
| STATUS_EA_LIST_INCONSISTENT | L'elenco EA che punta a Buffer non è formattato correttamente. Si tratta di un codice di errore. |
| STATUS_INSUFFICIENT_RESOURCES | Non è disponibile memoria sufficiente per completare l'operazione. Si tratta di un codice di errore. |
Commenti
ZwSetEaFile sostituisce gli EAs associati a FileHandle con IAs nel buffer a cui punta Buffer . Gli EA nel buffer devono essere formattati come sequenza di strutture FILE_FULL_EA_INFORMATION . ZwSetEaFileverifica prima che il buffer dei valori EA sia valido prima di sostituire gli EA esistenti.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 |
| Piattaforma di destinazione | Universale |
| Intestazione | ntifs.h (include FltKernel.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |