Fonction ZwQueryEaFile (ntifs.h)
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) |