ZwQueryEaFile, fonction (ntifs.h)

Article
02/29/2024

La routine ZwQueryEaFile retourne des informations sur les valeurs d’attribut étendu (EA) pour un fichier.

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 la status d’achèvement finale et d’autres informations sur l’opération demandée.

[out] Buffer

Pointeur vers une mémoire tampon de sortie FILE_FULL_EA_INFORMATION structurée fournie par l’appelant, où les valeurs d’attribut étendu doivent être retournées.

[in] Length

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

[in] ReturnSingleEntry

Défini sur TRUE si ZwQueryEaFile doit retourner uniquement la première entrée trouvée.

[in, optional] EaList

Pointeur vers une mémoire tampon d’entrée FILE_GET_EA_INFORMATION structurée fournie par l’appelant, qui spécifie les attributs étendus à 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 d’attributs étendus du fichier doit commencer. Ce paramètre est ignoré si le paramètre EaList pointe vers une liste non 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 des attributs étendus 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 attributs étendus. Il s’agit d’un code d’erreur.
STATUS_INSUFFICIENT_RESOURCES	La routine ZwQueryEaFile a rencontré un échec d’allocation de pool. 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.

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