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 |
---|---|
|
Le système de fichiers ne prend pas en charge les attributs étendus. Il s’agit d’un code d’erreur. |
|
L’instance ou le volume est détruit. Il s’agit d’un code d’erreur. |
|
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 |