FsRtlSetKernelEaFile, fonction (ntifs.h)

Article
12/21/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, en retournant un résultat. Il définit le code secondaire IRP_MN_KERNEL qui permet à cette API de définir SecureEAs. Cela permet à l’appelant de le faire 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 FileObject pour envoyer la requête QueryEA à.

[in] EaBuffer

Pointeur vers un tampon d’entrée FILE_FULL_EA_INFORMATION-structured input fourni 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 de retour

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

Retourner le code	Description
STATUS_EA_LIST_INCONSISTENT	Le paramètre EaList n’est pas correctement mis en forme.
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 demande ne peut pas mélanger les données normales et noyaux EA 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 réussi.

Remarques

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

Un ou plusieurs noyaux EA peuvent être définis, modifiés et/ou supprimés dans un seul appel à FsRtlSetKernelEaFile. Les ea normaux peuvent également être définis à l’aide de la fonction FsRtlSetKernelEaFile. Vous supprimez les ea en spécifiant un EAName avec un EaValueLength de zéro. Vous pouvez mélanger l’insertion d’un nouvel appel, la modification ou la suppression des ea dans un seul appel.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8
serveur minimum pris en charge	Windows Server 2012
plateforme cible	Windows
d’en-tête	ntifs.h

Voir aussi

FsRtlQueryKernelEaFile

ZwQueryEaFile

ZwSetEaFile

Partager via