FltPurgeFileNameInformationCache function (fltkernel.h)

FltPurgeFileNameInformationCache purges from the Filter Manager's name cache all file name information structures that were generated from names provided by the given minifilter driver instance.

Syntax

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

Parameters

[in] Instance

Opaque instance (PFLT_INSTANCE) pointer for the minifilter driver instance whose names are to be purged. This parameter is required and cannot be NULL.

[in, optional] FileObject

Optional pointer to a file object for which all names are to be purged. If this parameter is NULL, all names for the minifilter driver instance specified by the Instance parameter are purged.

Return value

FltPurgeFileNameInformationCache returns STATUS_SUCCESS or an appropriate NTSTATUS value.

Remarks

A minifilter driver that provides file names for the Filter Manager's name cache can call FltPurgeFileNameInformationCache to purge the names provided for a given minifilter driver instance. This is most commonly done when a name-providing filter unloads.

The file name information structures are not freed until all references are released.

Requirements

See also

FLT_NAME_CONTROL

FltCheckAndGrowNameControl

FltGetFileNameFormat

FltGetFileNameInformation

FltGetFileNameInformationUnsafe

FltGetFileNameQueryMethod

PFLT_GENERATE_FILE_NAME

PFLT_NORMALIZE_CONTEXT_CLEANUP

PFLT_NORMALIZE_NAME_COMPONENT