Fonction ZwSetEaFile (ntifs.h)
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) |