Fungsi OpenFileMappingFromApp (memoryapi.h)

Membuka objek pemetaan file bernama.

Sintaks

HANDLE OpenFileMappingFromApp(
  [in] ULONG  DesiredAccess,
  [in] BOOL   InheritHandle,
  [in] PCWSTR Name
);

Parameter

[in] DesiredAccess

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. Anda hanya dapat membuka objek pemetaan file untuk akses FILE_MAP_EXECUTE jika aplikasi Anda memiliki kemampuan codeGeneration .

[in] InheritHandle

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

[in] Name

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 DesiredAccess , operasi terbuka berhasil. Nama dapat memiliki awalan "Global" atau "Lokal" 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.

Menampilkan 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

Anda dapat memanggil OpenFileMappingFromApp dari aplikasi Windows Store dengan kemampuan just-in-time (JIT) untuk menggunakan fungsionalitas JIT. Aplikasi harus menyertakan kemampuan codeGeneration dalam file manifes aplikasi untuk menggunakan kemampuan JIT. OpenFileMappingFromApp memungkinkan aplikasi Windows Store menggunakan kelas MemoryMappedFile di .NET Framework.

Handel yang dikembalikan OpenFileMappingFromApp 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 OpenFileMappingFromApp dengan panggilan ke CloseHandle.

Persyaratan

   
Klien minimum yang didukung Windows 10 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2016 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header memoryapi.h (termasuk Windows.h)
Pustaka WindowsApp.lib
DLL Kernel32.dll

Lihat juga

CreateFileMapping

Fungsi Pemetaan File

Fungsi Manajemen Memori

OpenFileMapping

Berbagi File dan Memori