ZwSetEaFile, fonction (ntifs.h)
ZwSetEaFile remplace les attributs étendus associés à un fichier par les autorités de certification spécifiées.
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 IO_STATUS_BLOCK qui reçoit l’état d’achèvement final et d’autres informations sur l’opération demandée.
[in] Buffer
Pointeur vers une FILE_FULL_EA_INFORMATIONmémoire tampon d’entrée structurée fournie par l’appelant qui contient les nouvelles EA qui remplacent les EA actuellement associées au fichier.
[in] Length
Longueur, en octets, de la mémoire tampon vers laquelle pointe le paramètre tampon.
Valeur de retour
ZwSetEaFile retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple :
| Valeur de retour | Description |
|---|---|
| STATUS_EA_LIST_INCONSISTENT | La liste EA vers laquelle tampon points n’est pas correctement mise en forme. Il s’agit d’un code d’erreur. |
| STATUS_INSUFFICIENT_RESOURCES | Il n’y a pas suffisamment de mémoire disponible pour terminer l’opération. Il s’agit d’un code d’erreur. |
Remarques
ZwSetEaFile remplace les EAs associées à FileHandle par les autorités de sécurité dans la mémoire tampon vers laquelle tampon pointe. Les EA dans la mémoire tampon doivent être mises en forme sous forme de séquence de structures FILE_FULL_EA_INFORMATION. ZwSetEaFile premier vérifie que la mémoire tampon des valeurs EA est valide avant de remplacer les autorités de certification existantes.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 |
| plateforme cible | Universel |
| d’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) |