Fonction FltQueryEaFile (fltkernel.h)

Article
02/29/2024

FltQueryEaFile retourne des informations sur les valeurs d’attribut étendu (EA) 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 de instance opaque pour le pilote de minifiltre instance à laquelle l’opération QueryEa doit être envoyée. Le instance doit être attaché 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 étendues doivent être retournées.

[in] Length

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

[in] ReturnSingleEntry

Définissez sur TRUE si FltQueryEaFile 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 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 vide. Ce paramètre est facultatif et peut être NULL.

[in] RestartScan

Définissez 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 retournée

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

Code de retour	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	Le instance ou le volume est en train d’être 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.

Configuration requise

Condition requise	Valeur
Client minimal 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	Universal
En-tête	fltkernel.h (inclure Fltkernel.h)
Bibliothèque	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

Voir aussi

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

FltSetEaFile

IoCheckEaBufferValidity

Partager via