Fonction ZwSetEaFile (ntifs.h)

  • Article

ZwSetEaFile remplace les attributs étendus (EA) associés à un fichier par les EAs spécifiés.

Syntaxe

NTSTATUS ZwSetEaFile(
  [in]  HANDLE           FileHandle,
  [out] PIO_STATUS_BLOCK IoStatusBlock,
  [in]  PVOID            Buffer,
  [in]  ULONG            Length
);

Paramètres

[in] FileHandle

Handle du fichier sur lequel l’opération doit être effectuée.

[out] IoStatusBlock

Pointeur vers une structure de IO_STATUS_BLOCK qui reçoit le status d’achèvement final et d’autres informations sur l’opération demandée.

[in] Buffer

Pointeur vers une mémoire tampon d’entrée FILE_FULL_EA_INFORMATION structurée fournie par l’appelant qui contient les nouvelles EA qui remplaceront les EA actuellement associées au fichier.

[in] Length

Longueur, en octets, de la mémoire tampon vers laquelle pointe le paramètre Buffer .

Valeur retournée

ZwSetEaFile retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple :

Valeur retournée Description
STATUS_EA_LIST_INCONSISTENT La liste EA vers laquelle la mémoire tampon pointe n’est pas mise en forme correctement. Il s’agit d’un code d’erreur.
STATUS_INSUFFICIENT_RESOURCES Il n’y a pas assez de mémoire disponible pour terminer l’opération. Il s’agit d’un code d’erreur.

Remarques

ZwSetEaFile remplace les EA associées à FileHandle par les EA dans la mémoire tampon vers laquelle la mémoire tampon pointe. Les EA dans la mémoire tampon doivent être mises en forme sous forme d’une séquence de structures FILE_FULL_EA_INFORMATION . ZwSetEaFilevérifie d’abord que la mémoire tampon des valeurs EA est valide avant de remplacer les EA existantes.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000
Plateforme cible Universal
En-tête ntifs.h (include FltKernel.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Règles de conformité DDI HwStorPortProhibitedDDIs(storport),PowerIrpDDis(wdm)

Voir aussi

FILE_FULL_EA_INFORMATION

IoCheckEaBufferValidity

ZwQueryEaFile