FltPurgeFileNameInformationCache-Funktion (fltkernel.h)

Artikel
02/29/2024

FltPurgeFileNameInformationCache löscht aus dem Namen des Filter-Managers alle Dateinameninformationsstrukturen zwischen, die aus Namen generiert wurden, die vom angegebenen Minifiltertreiber instance bereitgestellt wurden.

Syntax

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

Parameter

[in] Instance

Undurchsichtiger instance -Zeiger (PFLT_INSTANCE) für den Minifiltertreiber instance dessen Namen gelöscht werden sollen. Dieser Parameter ist erforderlich und darf nicht NULL sein.

[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 den Minifiltertreiber instance, die vom Parameter Instance angegeben werden, gelöscht.

Rückgabewert

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

Hinweise

Ein Minifiltertreiber, der Dateinamen für den Namencache des Filter-Managers bereitstellt, kann FltPurgeFileNameInformationCache aufrufen, um die Namen zu bereinigen, die für einen bestimmten Minifiltertreiber instance. Dies geschieht am häufigsten, wenn ein namensbasierter Filter entladen wird.

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