Fonction ZwQueryEaFile (ntifs.h)

Article
04/29/2024

La routine ZwQueryEaFile retourne les attributs étendus (EA) associés au fichier spécifié.

Syntaxe

NTSTATUS ZwQueryEaFile(
  [in]           HANDLE           FileHandle,
  [out]          PIO_STATUS_BLOCK IoStatusBlock,
  [out]          PVOID            Buffer,
  [in]           ULONG            Length,
  [in]           BOOLEAN          ReturnSingleEntry,
  [in, optional] PVOID            EaList,
  [in]           ULONG            EaListLength,
  [in, optional] PULONG           EaIndex,
  [in]           BOOLEAN          RestartScan
);

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.

[out] Buffer

Pointeur vers une mémoire tampon de sortie structurée FILE_FULL_EA_INFORMATION fournie par l’appelant dans laquelle retourner les EA du fichier.

[in] Length

Longueur, en octets, de la mémoire tampon vers laquelle la mémoire tampon pointe.

[in] ReturnSingleEntry

Définissez sur TRUE si ZwQueryEaFile doit retourner uniquement la première entrée qu’il trouve.

[in, optional] EaList

Pointeur vers une mémoire tampon d’entrée structurée FILE_GET_EA_INFORMATION fournie par l’appelant qui spécifie les EA à interroger. Ce paramètre est facultatif et peut être NULL.

[in] EaListLength

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

[in, optional] EaIndex

Index de l’entrée à laquelle l’analyse de la liste EA du fichier doit commencer. Ce paramètre est ignoré si EaList pointe vers une liste vide. Ce paramètre est facultatif et peut être NULL.

[in] RestartScan

Définissez sur TRUE si ZwQueryEaFile doit commencer l’analyse à la première entrée de la liste EA du fichier. Si ce paramètre a la valeur FALSE, la routine reprend l’analyse d’un appel précédent à ZwQueryEaFile.

Valeur retournée

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

Valeur retournée	Description
STATUS_EAS_NOT_SUPPORTED	Le système de fichiers ne prend pas en charge les EAs. 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.
STATUS_EA_LIST_INCONSISTENT	Le paramètre EaList n’est pas mis en forme correctement. Il s’agit d’un code d’erreur.

Remarques

La quantité d’informations retournées par ZwQueryEaFile est basée sur la taille des EAs et la taille de la mémoire tampon vers laquelle la mémoire tampon pointe. Autrement dit, soit tous les EA demandés sont écrits dans la mémoire tampon, soit la mémoire tampon est remplie avec autant d’EAs complètes si elle n’est pas assez grande pour contenir toutes les EA. Seuls les EA complets sont écrits dans la mémoire tampon ; aucune EA partielle ne sera jamais retournée.

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

FILE_GET_EA_INFORMATION

ZwSetEaFile

Partager via