Función FltPurgeFileNameInformationCache (fltkernel.h)

Artículo
02/06/2025

FltPurgeFileNameInformationCache purgas del nombre del Administrador de filtros almacena en caché todas las estructuras de información de nombre de archivo generadas a partir de 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 necesario y no se puede 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 Instancia de.

Valor devuelto

fltPurgeFileNameInformationCache devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado.

Observaciones

Un controlador de minifiltro que proporciona 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.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	fltkernel.h (incluya Fltkernel.h)
biblioteca de	FltMgr.lib
DLL de	Fltmgr.sys
irQL	<= APC_LEVEL