Fungsi SymFindExecutableImage (dbghelp.h)
Menemukan file yang dapat dieksekusi di jalur pencarian proses.
Sintaks
HANDLE IMAGEAPI SymFindExecutableImage(
[in] HANDLE hProcess,
[in] PCSTR FileName,
[out] PSTR ImageFilePath,
[in] PFIND_EXE_FILE_CALLBACK Callback,
[in] PVOID CallerData
);
Parameter
[in] hProcess
Handel ke proses yang awalnya diteruskan ke fungsi SymInitialize .
[in] FileName
Nama file yang dapat dieksekusi. Anda dapat menggunakan jalur parsial.
[out] ImageFilePath
Jalur file yang sepenuhnya memenuhi syarat dari file yang dapat dieksekusi. Buffer ini setidaknya harus MAX_PATH karakter.
[in] 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] CallerData
Nilai yang ditentukan pengguna atau NULL. Nilai ini hanya diteruskan ke fungsi panggilan balik. Parameter ini biasanya digunakan oleh aplikasi untuk meneruskan penunjuk ke struktur data yang menyediakan beberapa konteks untuk fungsi panggilan balik.
Mengembalikan 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 ini menggunakan set jalur pencarian menggunakan fungsi SymInitialize atau SymSetSearchPath .
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
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | dbghelp.h |
Pustaka | Dbghelp.lib |
DLL | Dbghelp.dll |
Redistribusi | DbgHelp.dll 6.6 atau yang lebih baru |
Lihat juga
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