Fungsi FindExecutableImageEx (dbghelp.h)
Menemukan file yang dapat dieksekusi yang ditentukan.
Sintaks
HANDLE IMAGEAPI FindExecutableImageEx(
[in] PCSTR FileName,
[in] PCSTR SymbolPath,
[out] PSTR ImageFilePath,
[in, optional] PFIND_EXE_FILE_CALLBACK Callback,
[in, optional] PVOID CallerData
);
Parameter
[in] FileName
Nama file simbol yang akan ditemukan. Parameter ini bisa menjadi jalur parsial.
[in] SymbolPath
Jalur tempat file simbol berada. String ini dapat berisi 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.
[in, optional] Callback
Fungsi panggilan balik yang ditentukan aplikasi yang memverifikasi apakah file yang dapat dieksekusi yang benar ditemukan, atau apakah fungsi harus melanjutkan pencariannya. Untuk informasi selengkapnya, lihat FindExecutableImageProc.
Parameter ini bisa NULL.
[in, optional] CallerData
Data opsional yang ditentukan pengguna untuk fungsi panggilan balik. Parameter ini bisa NULL.
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 FindExecutableImageEx disediakan sehingga file yang dapat dieksekusi dapat ditemukan di beberapa direktori yang berbeda dengan menggunakan satu panggilan fungsi. Jika parameter SymbolPath berisi beberapa jalur, fungsi akan mencari setiap pohon direktori yang ditentukan untuk file yang dapat dieksekusi. Ketika file ditemukan, pencarian 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.
Untuk memanggil versi Unicode dari fungsi ini, tentukan DBGHELP_TRANSLATE_TCHAR.
Persyaratan
Target Platform | Windows |
Header | dbghelp.h |
Pustaka | Dbghelp.lib |
DLL | Dbghelp.dll |
Redistribusi | DbgHelp.dll 5.1 atau yang lebih baru |