Export (0) Print
Expand All
Expand Minimize

FltPurgeFileNameInformationCache function

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 FltPurgeFileNameInformationCache(
  _In_     PFLT_INSTANCE Instance,
  _In_opt_ PFILE_OBJECT  FileObject
);

Parameters

Instance [in]

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

FileObject [in, optional]

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

Target platform

Universal

Header

Fltkernel.h (include Fltkernel.h)

Library

FltMgr.lib

IRQL

<= APC_LEVEL

See also

FLT_NAME_CONTROL
FltCheckAndGrowNameControl
FltGetFileNameFormat
FltGetFileNameInformation
FltGetFileNameInformationUnsafe
FltGetFileNameQueryMethod
PFLT_GENERATE_FILE_NAME
PFLT_NORMALIZE_CONTEXT_CLEANUP
PFLT_NORMALIZE_NAME_COMPONENT

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft