Fungsi UnmapViewOfFile (memoryapi.h)

Artikel
02/01/2024

Batalkan peta tampilan file yang dipetakan dari ruang alamat proses panggilan.

Sintaks

BOOL UnmapViewOfFile(
  [in] LPCVOID lpBaseAddress
);

Parameter

[in] lpBaseAddress

Penunjuk ke alamat dasar tampilan file yang dipetakan yang tidak akan dipetakan. Nilai ini harus identik dengan nilai yang dikembalikan oleh panggilan sebelumnya ke salah satu fungsi dalam keluarga MapViewOfFile .

Mengembalikan nilai

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

Membatalkan pemetaan tampilan file yang dipetakan membatalkan rentang yang ditempati oleh tampilan di ruang alamat proses dan membuat rentang tersedia untuk alokasi lain. Ini menghapus entri set kerja untuk setiap halaman virtual yang tidak dipetakan yang merupakan bagian dari set proses yang berfungsi dan mengurangi ukuran set kerja proses. Ini juga mengurangi jumlah berbagi halaman fisik yang sesuai.

Halaman yang dimodifikasi dalam tampilan yang tidak dipetakan tidak ditulis ke disk sampai jumlah berbaginya mencapai nol, atau dengan kata lain, sampai tidak dipetakan atau dipangkas dari set kerja dari semua proses yang berbagi halaman. Bahkan kemudian, halaman yang dimodifikasi ditulis "malas" ke disk; artinya, modifikasi dapat di-cache dalam memori dan ditulis ke disk di lain waktu. Untuk meminimalkan risiko kehilangan data jika terjadi kegagalan daya atau crash sistem, aplikasi harus secara eksplisit menghapus halaman yang dimodifikasi menggunakan fungsi FlushViewOfFile .

Meskipun aplikasi dapat menutup handel file yang digunakan untuk membuat objek pemetaan file, sistem akan membuka file yang sesuai hingga tampilan terakhir file tidak dipetakan. File yang tampilan terakhirnya belum dipetakan akan dibuka tanpa batasan berbagi.

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

Contoh

Misalnya, lihat Membuat Tampilan Dalam File.

Persyaratan


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