Функция FltPurgeFileNameInformationCache (fltkernel.h)

Статья
02/26/2024

FltPurgeFileNameInformationCache удаляет из кэша имени диспетчера фильтров все структуры сведений об именах файлов, созданные на основе имен, предоставленных заданным экземпляром драйвера минифильтра.

Синтаксис

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

Параметры

[in] Instance

Указатель непрозрачного экземпляра (PFLT_INSTANCE) для экземпляра драйвера минифильтра, имена которого необходимо очистить. Этот параметр является обязательным и не может иметь значение NULL.

[in, optional] FileObject

Необязательный указатель на объект файла, для которого необходимо очистить все имена. Если этот параметр имеет значение NULL, все имена экземпляра драйвера минифильтра, указанного параметром Instance , удаляются.

Возвращаемое значение

FltPurgeFileNameInformationCache возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS.

Драйвер минифильтра, предоставляющий имена файлов для кэша имен диспетчера фильтров, может вызвать FltPurgeFileNameInformationCache для очистки имен, предоставленных для данного экземпляра драйвера минифильтра. Чаще всего это делается при выгрузке фильтра с указанием имени.

Структуры сведений об именах файлов не освобождаются до тех пор, пока не будут освобождены все ссылки.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	fltkernel.h (включая Fltkernel.h)
Библиотека	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL