Fungsi FlushViewOfFile (memoryapi.h)

Menulis ke disk rentang byte dalam tampilan file yang dipetakan.

Sintaks

BOOL FlushViewOfFile(
  [in] LPCVOID lpBaseAddress,
  [in] SIZE_T  dwNumberOfBytesToFlush
);

Parameter

[in] lpBaseAddress

Penunjuk ke alamat dasar rentang byte yang akan disiram ke representasi disk file yang dipetakan.

[in] dwNumberOfBytesToFlush

Jumlah byte yang akan dibersihkan. Jika dwNumberOfBytesToFlush adalah nol, file akan dihapus dari alamat dasar ke akhir pemetaan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Menghapus berbagai tampilan yang dipetakan memulai penulisan halaman kotor dalam rentang tersebut ke disk. Halaman kotor adalah halaman yang isinya telah berubah sejak tampilan file dipetakan. Fungsi FlushViewOfFile tidak membersihkan metadata file, dan tidak menunggu untuk kembali sampai perubahan dihapus dari cache disk perangkat keras yang mendasarinya dan ditulis secara fisik ke disk. Untuk membersihkan semua halaman kotor ditambah metadata untuk file dan memastikan bahwa mereka ditulis secara fisik ke disk, panggil FlushViewOfFile dan kemudian panggil fungsi FlushFileBuffers .

Saat membersihkan file yang dipetakan memori melalui jaringan, FlushViewOfFile menjamin bahwa data telah ditulis dari komputer lokal, tetapi tidak bahwa data berada di komputer jarak jauh. Server dapat menyimpan data di sisi jarak jauh. Oleh karena itu, FlushViewOfFile dapat kembali sebelum data ditulis secara fisik ke disk.

Saat memodifikasi file melalui tampilan yang dipetakan, tanda waktu modifikasi terakhir mungkin tidak diperbarui secara otomatis. Jika diperlukan, pemanggil harus menggunakan SetFileTime untuk mengatur tanda waktu.

Di Windows Server 2012, fungsi ini didukung oleh teknologi berikut.

Teknologi	Didukung
Protokol Server Message Block (SMB) 3.0	Ya
SMB 3.0 Transparent Failover (TFO)	Ya
SMB 3.0 dengan Berbagi File Peluasan Skala (SO)	Ya
Sistem File Volume Bersama Kluster (CsvFS)	Ya
Sistem File Tangguh (ReFS)	Ya

 

Ketika CsvF dijeda, panggilan ini mungkin gagal dengan kesalahan yang menunjukkan bahwa ada konflik kunci.

Contoh

Misalnya, lihat Membaca dan Menulis Dari Tampilan File.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	memoryapi.h (termasuk Windows.h, Memoryapi.h)
Pustaka	onecore.lib
DLL	Kernel32.dll

Lihat juga

CreateFile

Membuat Tampilan File

Fungsi Pemetaan File

MapViewOfFile

UnmapViewOfFile