Funzione ZwSetEaFile (ntifs.h)

Articolo
12/21/2024

ZwSetEaFile sostituisce gli attributi estesi associati a un file con le EA specificate.

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 deve essere eseguita 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_INFORMATIONbuffer di input strutturato contenente i nuovi EA che sostituiranno gli EA attualmente 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:

Valore restituito	Descrizione
STATUS_EA_LIST_INCONSISTENT	L'elenco EA a cui buffer punta non è formattato correttamente. Si tratta di un codice di errore.
STATUS_INSUFFICIENT_RESOURCES	Memoria insufficiente per completare l'operazione. Si tratta di un codice di errore.

Osservazioni

ZwSetEaFile sostituisce gli EA associati a FileHandle con gli EA nel buffer a cui buffer punta. Gli EA nel buffer devono essere formattati come sequenza di strutture FILE_FULL_EA_INFORMATION. ZwSetEaFile prima verifica che il buffer dei valori EA sia valido prima di sostituire gli EA esistenti.

Fabbisogno

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)

Vedere anche

FILE_FULL_EA_INFORMATION

IoCheckEaBufferValidity

ZwQueryEaFile

Condividi tramite