Funzione ZwSetEaFile (ntifs.h)

  • Articolo

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)

Vedi anche

FILE_FULL_EA_INFORMATION

IoCheckEaBuffer Validità

ZwQueryEaFile