Fungsi MapAndLoad (imagehlp.h)
Memetakan gambar dan memuat data sebelumnya dari file yang dipetakan.
Sintaks
BOOL IMAGEAPI MapAndLoad(
[in] PCSTR ImageName,
[in] PCSTR DllPath,
[out] PLOADED_IMAGE LoadedImage,
[in] BOOL DotDll,
[in] BOOL ReadOnly
);
Parameter
[in] ImageName
Nama file gambar (file yang dapat dieksekusi atau DLL) yang dimuat.
[in] DllPath
Jalur yang digunakan untuk menemukan gambar jika nama yang disediakan tidak dapat ditemukan. Jika parameter ini NULL, maka aturan jalur pencarian yang ditetapkan menggunakan fungsi SearchPath berlaku.
[out] LoadedImage
Penunjuk ke struktur LOADED_IMAGE yang menerima informasi tentang gambar setelah dimuat.
[in] DotDll
Ekstensi default yang akan digunakan jika nama gambar tidak berisi ekstensi nama file. Jika nilainya TRUE, ekstensi .DLL digunakan. Jika nilainya FALSE, maka ekstensi .EXE digunakan.
[in] ReadOnly
Mode akses. Jika nilai ini TRUE, file dipetakan hanya untuk akses baca. Jika nilainya FALSE, file dipetakan untuk akses baca dan tulis.
Menampilkan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE.
Jika fungsi gagal, nilai yang dikembalikan adalah FALSE. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.
Keterangan
Fungsi MapAndLoad memetakan gambar dan memuat data sebelumnya dari file yang dipetakan. Fungsi yang sesuai, UnMapAndLoad, harus digunakan untuk membatalkan alokasi semua sumber daya yang dialokasikan oleh fungsi MapAndLoad .
Semua fungsi ImageHlp, seperti ini, adalah utas tunggal. Oleh karena itu, panggilan dari lebih dari satu utas ke fungsi ini kemungkinan akan mengakibatkan perilaku tak terduga atau kerusakan memori. Untuk menghindari hal ini, Anda harus menyinkronkan semua panggilan bersamaan dari lebih dari satu utas ke fungsi ini.
Persyaratan
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | imagehlp.h |
| Pustaka | Imagehlp.lib |
| DLL | Imagehlp.dll |