Fungsi OpenFileMappingA (winbase.h)

Membuka objek pemetaan file bernama.

Sintaks

HANDLE OpenFileMappingA(
  [in] DWORD  dwDesiredAccess,
  [in] BOOL   bInheritHandle,
  [in] LPCSTR lpName
);

Parameter

[in] dwDesiredAccess

Akses ke objek pemetaan file. Akses ini diperiksa terhadap deskriptor keamanan apa pun pada objek pemetaan file target. Untuk daftar nilai, lihat Keamanan Pemetaan File dan Hak Akses.

[in] bInheritHandle

Jika parameter ini TRUE, proses yang dibuat oleh fungsi CreateProcess dapat mewarisi handel; jika tidak, handel tidak dapat diwariskan.

[in] lpName

Nama objek pemetaan file yang akan dibuka. Jika ada handel terbuka ke objek pemetaan file dengan nama ini dan deskriptor keamanan pada objek pemetaan tidak bertentangan dengan parameter dwDesiredAccess , operasi terbuka berhasil. Nama dapat memiliki awalan "Global\" atau "Local\" untuk secara eksplisit membuka objek di namespace layanan global atau sesi. Sisa nama dapat berisi karakter apa pun kecuali karakter garis miring terbelakang (\). Untuk informasi selengkapnya, lihat Namespace Objek Kernel. Pengalihan pengguna cepat diimplementasikan menggunakan sesi Layanan Terminal. Pengguna pertama yang masuk menggunakan sesi 0, pengguna berikutnya untuk masuk menggunakan sesi 1, dan sebagainya. Nama objek kernel harus mengikuti pedoman yang diuraikan untuk Layanan Terminal sehingga aplikasi dapat mendukung beberapa pengguna.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah handel terbuka ke objek pemetaan file yang ditentukan.

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

Keterangan

Handel yang dikembalikan OpenFileMapping dapat digunakan dengan fungsi apa pun yang memerlukan handel ke objek pemetaan file.

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.

Ketika tidak lagi diperlukan, pemanggil harus memanggil rilis handel yang dikembalikan oleh OpenFileMapping dengan panggilan ke CloseHandle.

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 Scale-out File Shares (SO)	Ya
Sistem File Volume Bersama Kluster (CsvFS)	Ya
Sistem File Tangguh (ReFS)	Ya

 

Contoh

Misalnya, lihat Membuat Memori Bersama Bernama.

Persyaratan

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

Lihat juga

CreateFileMapping

Fungsi Pemetaan File

Fungsi Manajemen Memori

Berbagi File dan Memori