Funzione FltPurgeFileNameInformationCache (fltkernel.h)

Articolo
02/06/2025

FltPurgeFileNameInformationCache elimina dal nome di Gestione filtri tutte le strutture di informazioni sui nomi 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 dell'istanza opaca (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 Istanza di vengono eliminati.

Valore restituito

FltPurgeFileNameInformationCache restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato.

Osservazioni

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

Le strutture di informazioni sui nomi di file non vengono liberate finché non vengono rilasciati tutti i riferimenti.