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

Lihat juga

Fungsi DbgHelp

FindExecutableImageProc

SymGetSearchPath