Função FltPurgeFileNameInformationCache (fltkernel.h)

Artigo
02/26/2024

FltPurgeFileNameInformationCache limpa do cache de nomes do Gerenciador de Filtros 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 opaco (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 Instance serão limpos.

Retornar valor

FltPurgeFileNameInformationCache retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado.

Comentários

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 é mais comumente 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 lançadas.