Fungsi FltPurgeFileNameInformationCache (fltkernel.h)

Artikel
02/26/2024

FltPurgeFileNameInformationCache menghapus menyeluruh dari nama Manajer Filter menyimpan semua struktur informasi nama file yang dihasilkan dari nama yang disediakan oleh instans driver minifilter yang diberikan.

Sintaks

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

Parameter

[in] Instance

Penunjuk instans buram (PFLT_INSTANCE) untuk instans driver minifilter yang namanya akan dihapus menyeluruh. Parameter ini diperlukan dan tidak boleh NULL.

[in, optional] FileObject

Penunjuk opsional ke objek file yang semua namanya akan dibersihkan. Jika parameter ini NULL, semua nama untuk instans driver minifilter yang ditentukan oleh parameter Instans dihapus menyeluruh.

Nilai kembali

FltPurgeFileNameInformationCache mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai.

Keterangan

Driver minifilter yang menyediakan nama file untuk cache nama Manajer Filter dapat memanggil FltPurgeFileNameInformationCache untuk menghapus menyeluruh nama yang disediakan untuk instans driver minifilter tertentu. Ini paling umum dilakukan ketika filter yang menyediakan nama dibongkar.

Struktur informasi nama file tidak dibebaskan sampai semua referensi dirilis.