FltPurgeFileNameInformationCache-Funktion (fltkernel.h)

Artikel
02/06/2025

FltPurgeFileNameInformationCache Löschvorgänge aus dem Namencache des Filter-Managers alle Dateinameninformationsstrukturen, die aus Namen generiert wurden, die von der angegebenen Minifiltertreiberinstanz generiert wurden.

Syntax

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

Parameter

[in] Instance

Undurchsichtiger Instanzzeiger (PFLT_INSTANCE) für die Minifiltertreiberinstanz, deren Namen gelöscht werden sollen. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

[in, optional] FileObject

Optionaler Zeiger auf ein Dateiobjekt, für das alle Namen gelöscht werden sollen. Wenn dieser Parameter NULL-ist, werden alle Namen für die minifilter-Treiberinstanz gelöscht, die durch den parameter Instance angegeben wird.

Rückgabewert

FltPurgeFileNameInformationCache gibt STATUS_SUCCESS oder einen entsprechenden NTSTATUS-Wert zurück.

Bemerkungen

Ein Minifiltertreiber, der Dateinamen für den Namenscache des Filter-Managers bereitstellt, kann FltPurgeFileNameInformationCache- aufrufen, um die für eine bestimmte Minifiltertreiberinstanz bereitgestellten Namen zu löschen. Dies geschieht am häufigsten, wenn ein name-providing filter unloads.

Die Dateinameninformationsstrukturen werden erst freigegeben, wenn alle Verweise freigegeben werden.