Fungsi FindExecutableImage (dbghelp.h)
Menemukan file yang dapat dieksekusi.
Untuk menentukan fungsi panggilan balik, gunakan fungsi FindExecutableImageEx .
Sintaks
HANDLE IMAGEAPI FindExecutableImage(
[in] PCSTR FileName,
[in] PCSTR SymbolPath,
[out] PSTR ImageFilePath
);
Parameter
[in] FileName
Nama file simbol yang akan ditemukan. Parameter ini bisa menjadi jalur parsial.
[in] SymbolPath
Jalur tempat file simbol berada. Ini bisa menjadi beberapa jalur yang dipisahkan oleh titik koma. Untuk mengambil jalur simbol, gunakan fungsi SymGetSearchPath .
[out] ImageFilePath
Penunjuk ke buffer yang menerima jalur lengkap file yang dapat dieksekusi.
Menampilkan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah handel terbuka ke file yang dapat dieksekusi.
Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.
Keterangan
Fungsi FindExecutableImage disediakan sehingga file yang dapat dieksekusi dapat ditemukan di beberapa direktori yang berbeda melalui satu panggilan fungsi. Parameter SymbolPath dapat berisi beberapa jalur, dengan masing-masing dipisahkan oleh titik koma (;). Ketika beberapa jalur ditentukan, fungsi mencari setiap pohon direktori untuk file yang dapat dieksekusi. Ketika file berada, pencarian akan berhenti. Dengan demikian, pastikan untuk menentukan SymbolPath dengan jalur dalam urutan yang benar.
Semua fungsi DbgHelp, 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
Target Platform | Windows |
Header | dbghelp.h |
Pustaka | Dbghelp.lib |
DLL | Dbghelp.dll |
Redistribusi | DbgHelp.dll 5.1 atau yang lebih baru |