Função FltPurgeFileNameInformationCache (fltkernel.h)

Artigo
02/06/2025

FltPurgeFileNameInformationCache limpa do cache de nomes do Gerenciador de Filtro todas as estruturas de informações de nome de arquivo que foram geradas a partir de nomes fornecidos pela instância de driver de minifiltro fornecida.

Sintaxe

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

Parâmetros

[in] Instance

Ponteiro de instância opaca (PFLT_INSTANCE) para a instância do driver de minifiltro cujos nomes devem ser limpos. Esse parâmetro é necessário e não pode ser NULL.

[in, optional] FileObject

Ponteiro opcional para um objeto de arquivo para o qual todos os nomes devem ser limpos. Se esse parâmetro for NULL, todos os nomes para a instância do driver de minifiltro especificada pelo parâmetro da Instância serão limpos.

Valor de retorno

FltPurgeFileNameInformationCache retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado.

Observações

Um driver de minifiltro que fornece nomes de arquivo para o cache de nomes do Gerenciador de Filtros pode chamar FltPurgeFileNameInformationCache para limpar os nomes fornecidos para uma determinada instância de driver de minifiltro. Isso geralmente é feito quando um filtro de fornecimento de nome é descarregado.

As estruturas de informações do nome do arquivo não são liberadas até que todas as referências sejam liberadas.