Fungsi OpenFileMappingA (winbase.h)

Membuka objek pemetaan file bernama.

Sintaksis

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. Peralihan 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 panduan yang diuraikan untuk Layanan Terminal sehingga aplikasi dapat mendukung beberapa pengguna.

Mengembalikan nilai

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

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

Komentar

Handel yang pengembalian 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 merilis handel yang dikembalikan oleh OpenFileMapping dengan panggilan ke CloseHandle.

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

Contoh

Misalnya, lihat Membuat Memori Bersama Bernama.

Persyaratan

Lihat juga

CreateFileMapping

Fungsi Pemetaan File

Fungsi Manajemen Memori

Berbagi File dan Memori