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
Fungsi Manajemen Memori
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk