FltPurgeFileNameInformationCache, fonction (fltkernel.h)

Article
02/06/2025

FltPurgeFileNameInformationCache purge à partir du cache de noms du Gestionnaire de filtres toutes les structures d’informations de nom de fichier générées à partir de noms fournis par l’instance de pilote minifilter donnée.

Syntaxe

NTSTATUS FLTAPI FltPurgeFileNameInformationCache(
  [in]           PFLT_INSTANCE Instance,
  [in, optional] PFILE_OBJECT  FileObject
);

Paramètres

[in] Instance

Pointeur d’instance opaque (PFLT_INSTANCE) pour l’instance de pilote minifilter dont les noms doivent être vidés. Ce paramètre est obligatoire et ne peut pas être NULL.

[in, optional] FileObject

Pointeur facultatif vers un objet de fichier pour lequel tous les noms doivent être vidés. Si ce paramètre est NULL, tous les noms de l’instance de pilote minifilter spécifiée par le paramètre Instance sont vidés.

Valeur de retour

FltPurgeFileNameInformationCache retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée.

Remarques

Un pilote minifilter qui fournit des noms de fichiers pour le cache de noms du Gestionnaire de filtres peut appeler FltPurgeFileNameInformationCache pour vider les noms fournis pour une instance de pilote minifilter donnée. Cela est le plus souvent effectué lorsqu’un filtre fournissant un nom est déchargé.

Les structures d’informations de nom de fichier ne sont pas libérées tant que toutes les références ne sont pas publiées.