Fungsi FindDebugInfoFileEx (dbghelp.h)
Menemukan file debug (.dbg) yang ditentukan.
Sintaks
HANDLE IMAGEAPI FindDebugInfoFileEx(
[in] PCSTR FileName,
[in] PCSTR SymbolPath,
[out] PSTR DebugFilePath,
[in, optional] PFIND_DEBUG_FILE_CALLBACK Callback,
[in, optional] PVOID CallerData
);
Parameter
[in] FileName
Nama file .dbg yang akan ditemukan. Anda dapat menggunakan 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] DebugFilePath
Penunjuk ke buffer yang menerima jalur lengkap file .dbg.
[in, optional] Callback
Fungsi panggilan balik yang ditentukan aplikasi yang memverifikasi apakah file yang benar ditemukan atau fungsi harus melanjutkan pencariannya. Untuk informasi selengkapnya, lihat FindDebugInfoFileProc.
Parameter ini mungkin NULL.
[in, optional] CallerData
Data opsional yang ditentukan pengguna untuk diteruskan ke fungsi panggilan balik.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah handel terbuka ke file .dbg.
Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.
Keterangan
Fungsi FindDebugInfoFileEx digunakan untuk menemukan file .dbg. Fungsi ini disediakan sehingga pencarian dapat dilakukan 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 direktori yang ditentukan untuk file tersebut. Ketika file berada, pencarian akan berhenti. Dengan demikian, pastikan untuk menentukan SymbolPath dengan jalur dalam urutan yang benar.
Jika nama file yang ditentukan tidak menyertakan ekstensi .dbg, FindDebugInfoFileEx mencari file dalam urutan berikut:
- SymbolPath\Symbols\ext\filename.dbg
- SymbolPath\ext\filename.dbg
- SymbolPath\filename.dbg
- FileNamePath\filename.dbg
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 5.1 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