ZwQueryEaFile, fonction (ntifs.h)

Article
12/21/2024

ZwQueryEaFile routine retourne les attributs étendus 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 IO_STATUS_BLOCK qui reçoit l’état 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 fournie par l’appelant FILE_FULL_EA_INFORMATIONdans laquelle retourner les EA du fichier.

[in] Length

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

[in] ReturnSingleEntry

Défini sur TRUE si ZwQueryEaFile ne doit retourner que la première entrée qu’elle trouve.

[in, optional] EaList

Pointeur vers une mémoire tampon d’entrée structurée fournie FILE_GET_EA_INFORMATIONpar l’appelant qui spécifie les EAs à 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 non vide. Ce paramètre est facultatif et peut être NULL.

[in] RestartScan

Défini sur TRUE si ZwQueryEaFile devez 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 de retour

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

Valeur de retour	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 suffisamment 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 correctement mis en forme. Il s’agit d’un code d’erreur.

Remarques

La quantité d’informations qui ZwQueryEaFile retourne est basée sur la taille des EA et la taille de la mémoire tampon vers laquelle tampon pointe. Autrement dit, tous les EA demandés sont écrits dans la mémoire tampon, ou la mémoire tampon est remplie avec autant d’EA complètes si elle n’est pas assez grande pour contenir toutes les EA. Seules les EA complètes sont écrites dans la mémoire tampon ; aucune autorisation partielle n’est jamais retournée.

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)

Voir aussi

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

ZwSetEaFile

Partager via