Fungsi CcPurgeCacheSection (ntifs.h)

Artikel
02/26/2024

Rutinitas CcPurgeCacheSection membersihkan semua atau sebagian file yang di-cache dari cache sistem.

Sintaks

BOOLEAN CcPurgeCacheSection(
  [in]           PSECTION_OBJECT_POINTERS SectionObjectPointer,
  [in, optional] PLARGE_INTEGER           FileOffset,
  [in]           ULONG                    Length,
                 ULONG                    Flags
);

Parameter

[in] SectionObjectPointer

Penunjuk ke struktur yang berisi penunjuk objek bagian objek file.

[in, optional] FileOffset

Penunjuk ke variabel yang menentukan offset byte awal dalam file yang di-cache tempat data akan dibersihkan.

Jika FileOffsetNULL, seluruh file akan dibersihkan dari cache.

Jika FileOffset bukan NULL, hanya rentang byte yang ditentukan oleh FileOffset dan Panjang yang dihapus menyeluruh.

[in] Length

Panjang rentang byte untuk menghapus menyeluruh, dimulai dari FileOffset. Jika Panjang adalah nol, rentang dari FileOffset hingga akhir file akan dibersihkan. Jika FileOffsetNULL, Panjang diabaikan.

Flags

Atur ke TRUE untuk membatalkan inisialisasi peta cache privat untuk file sebelum menghapus menyeluruh data file.

Nilai kembali

CcPurgeCacheSection mengembalikan TRUE jika data file yang di-cache berhasil dibersihkan, FALSE jika tidak.

Keterangan

Sistem file memanggil CcPurgeCacheSection untuk menghapus menyeluruh data kedaluarsa dari cache. Misalnya, ketika file dipotong tetapi tidak dihapus, CcPurgeCacheSection harus dipanggil untuk menghapus menyeluruh data yang di-cache yang tidak lagi menjadi bagian dari file.

CcPurgeCacheSection tidak akan menghapus menyeluruh file yang dipetakan.

Sebelum memanggil CcPurgeCacheSection, pemanggil harus memperoleh file secara eksklusif dan memastikan bahwa tidak ada utas, termasuk pemanggil, telah memetakan atau menyematkan rentang byte apa pun dalam file.