Funzione FltPurgeFileNameInformationCache (fltkernel.h)

Articolo
02/29/2024

FltPurgeFileNameInformationCache dal nome di Filter Manager memorizza nella cache tutte le strutture di informazioni sul nome del file generate dai nomi forniti dall'istanza del driver minifilter specificata.

Sintassi

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

Parametri

[in] Instance

Puntatore opaco (PFLT_INSTANCE) per l'istanza del driver minifilter i cui nomi devono essere eliminati. Questo parametro è obbligatorio e non può essere NULL.

[in, optional] FileObject

Puntatore facoltativo a un oggetto file per il quale tutti i nomi devono essere eliminati. Se questo parametro è NULL, tutti i nomi per l'istanza del driver minifilter specificato dal parametro Instance vengono eliminati.

Valore restituito

FltPurgeFileNameInformationCache restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato.

Commenti

Un driver minifilter che fornisce nomi di file per la cache dei nomi di Filter Manager può chiamare FltPurgeFileNameInformationCache per eliminare i nomi forniti per un'istanza del driver minifilter specificata. Questa operazione viene eseguita più comunemente quando un filtro che fornisce un nome scarica.

Le strutture di informazioni sul nome file non vengono liberate finché non vengono rilasciati tutti i riferimenti.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	fltkernel.h (includere Fltkernel.h)
Libreria	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL