Fonction FltPurgeFileNameInformationCache (fltkernel.h)

Article
02/26/2024

FltPurgeFileNameInformationCache vide du cache de noms du Gestionnaire de filtres toutes les structures d’informations de nom de fichier qui ont été générées à partir des noms fournis par le pilote minifiltre donné instance.

Syntaxe

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

Paramètres

[in] Instance

Pointeur de instance opaque (PFLT_INSTANCE) pour le pilote minifiltre instance dont les noms doivent être vidés. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.

[in, optional] FileObject

Pointeur facultatif vers un objet de fichier pour lequel tous les noms doivent être vidés. Si ce paramètre a la valeur NULL, tous les noms du pilote de minifiltre instance spécifiés par le paramètre Instance sont vidés.

Valeur retournée

FltPurgeFileNameInformationCache retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée.

Remarques

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

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.