Fonction FsRtlSetKernelEaFile (ntifs.h)

Article
02/26/2024

La routine FsRtlQueryKernelEaFile est utilisée pour définir, modifier et/ou supprimer des valeurs d’attribut étendu (EA) pour un fichier et attendre de façon synchrone qu’il se termine, renvoyant un résultat. Il définit le IRP_MN_KERNEL code mineur qui permet à cette API de définir SecureEAs. Cela permet à l’appelant d’effectuer cette opération par FileObject au lieu d’un handle.

Syntaxe

NTSTATUS FsRtlSetKernelEaFile(
  [in] PFILE_OBJECT FileObject,
  [in] PVOID        EaBuffer,
  [in] ULONG        Length
);

Paramètres

[in] FileObject

Pointeur vers un Objet FileObject vers lequel envoyer la requête QueryEA.

[in] EaBuffer

Pointeur vers une mémoire tampon d’entrée FILE_FULL_EA_INFORMATION structurée fournie par l’appelant qui contient les valeurs d’attribut étendues à définir

[in] Length

Spécifie la longueur de la mémoire tampon EA.

Valeur retournée

La routine FsRtlSetKernelEaFile reçoit les status de l’opération et retourne l’un des codes status :

Code de retour	Description
STATUS_EA_LIST_INCONSISTENT	Le paramètre EaList n’est pas mis en forme correctement.
STATUS_EAS_NOT_SUPPORTED	Le système de fichiers ne prend pas en charge les attributs étendus.
STATUS_INSUFFICIENT_RESOURCES	Le paquet de requête d’E/S (IRP) n’a pas pu être alloué pour cette requête.
STATUS_INTERMIXED_KERNEL_EA_OPERATION	La requête ne peut pas mélanger les eas normaux et du noyau dans le même appel.
STATUS_INVALID_DEVICE_REQUEST	La demande a échoué, car il s’agissait d’un appareil direct ouvert.
STATUS_SUCCESS	La demande a abouti.

Remarques

Cette routine suppose que toutes les mémoires tampons passées proviennent du mode noyau.

Un ou plusieurs EA du noyau peuvent être définis, modifiés et/ou supprimés en un seul appel à FsRtlSetKernelEaFile. Les EA normaux peuvent également être définis à l’aide de la fonction FsRtlSetKernelEaFile . Vous supprimez ea’s en spécifiant un EAName avec un EaValueLength de zéro. Vous pouvez mélanger en insérant de nouveaux, en modifiant des ea existants ou en supprimant des EA dans un seul appel.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Windows
En-tête	ntifs.h

Voir aussi

FsRtlQueryKernelEaFile

ZwQueryEaFile

ZwSetEaFile

Partager via