Partager via


FltQueryEaFile, fonction (fltkernel.h)

FltQueryEaFile retourne des informations sur les valeurs ea (extended-attribute) d’un fichier.

Syntaxe

NTSTATUS FLTAPI FltQueryEaFile(
  [in]            PFLT_INSTANCE Instance,
  [in]            PFILE_OBJECT  FileObject,
  [out]           PVOID         ReturnedEaData,
  [in]            ULONG         Length,
  [in]            BOOLEAN       ReturnSingleEntry,
  [in, optional]  PVOID         EaList,
  [in]            ULONG         EaListLength,
  [in, optional]  PULONG        EaIndex,
  [in]            BOOLEAN       RestartScan,
  [out, optional] PULONG        LengthReturned
);

Paramètres

[in] Instance

Pointeur d’instance opaque pour l’instance de pilote minifilter à laquelle l’opération de QueryEa doit être envoyée. L’instance doit être attachée au volume où réside le fichier.

[in] FileObject

Pointeur d’objet de fichier pour le fichier.

[out] ReturnedEaData

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

[in] Length

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

[in] ReturnSingleEntry

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

[in, optional] EaList

Pointeur vers une FILE_GET_EA_INFORMATIONmémoire tampon d’entrée 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 commencer l’analyse de la liste d’attributs étendus du fichier. 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éfini sur TRUE si FltQueryEaFile doit commencer l’analyse à la première entrée de la liste d’attributs étendus du fichier. Si ce paramètre n’est pas défini sur TRUE, l’analyse est reprise à partir d’un appel précédent à FltQueryEaFile.

[out, optional] LengthReturned

Pointeur vers une variable allouée par l’appelant qui reçoit la taille, en octets, des informations retournées dans la mémoire tampon ReturnedEaData. Ce paramètre est facultatif et peut être NULL.

Valeur de retour

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

Retourner le code 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_FLT_DELETING_OBJECT
L’instance ou le volume est détruit. Il s’agit d’un code d’erreur.
STATUS_INSUFFICIENT_RESOURCES
FltQueryEaFile a rencontré un échec d’allocation de pool. Il s’agit d’un code d’erreur.

Exigences

Exigence Valeur
client minimum pris en charge Disponible dans microsoft Windows 2000 Update Rollup 1 pour SP4, Windows XP SP3, Windows Server 2003 SP1 et versions ultérieures du système d’exploitation Windows.
plateforme cible Universel
d’en-tête fltkernel.h (include Fltkernel.h)
bibliothèque FltMgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

Voir aussi

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

fltSetEaFile

IoCheckEaBufferValidity