Función FltPurgeFileNameInformationCache (fltkernel.h)

Artículo
02/29/2024

FltPurgeFileNameInformationCache purga del nombre del Administrador de filtros almacena en caché todas las estructuras de información de nombre de archivo que se generaron a partir de los nombres proporcionados por la instancia de controlador de minifiltro especificada.

Sintaxis

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

Parámetros

[in] Instance

Puntero de instancia opaca (PFLT_INSTANCE) para la instancia del controlador de minifiltro cuyos nombres se van a purgar. Este parámetro es obligatorio y no puede ser NULL.

[in, optional] FileObject

Puntero opcional a un objeto de archivo para el que se van a purgar todos los nombres. Si este parámetro es NULL, se purgan todos los nombres de la instancia del controlador de minifiltro especificada por el parámetro Instance .

Valor devuelto

FltPurgeFileNameInformationCache devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado.

Comentarios

Un controlador de minifiltro que proporcione nombres de archivo para la caché de nombres del Administrador de filtros puede llamar a FltPurgeFileNameInformationCache para purgar los nombres proporcionados para una instancia de controlador de minifiltro determinada. Esto suele hacerse cuando se descarga un filtro que proporciona nombres.

Las estructuras de información del nombre de archivo no se liberan hasta que se liberan todas las referencias.