Fungsi FindDebugInfoFile (dbghelp.h)
Menemukan file debug (.dbg).
Untuk menyediakan fungsi panggilan balik untuk memverifikasi file simbol yang terletak, gunakan fungsi FindDebugInfoFileEx .
Sintaks
HANDLE IMAGEAPI FindDebugInfoFile(
[in] PCSTR FileName,
[in] PCSTR SymbolPath,
[out] PSTR DebugFilePath
);
Parameter
[in] FileName
Nama file .dbg yang diinginkan. 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.
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 FindDebugInfoFile 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 untuk file tersebut. Subdirektori tidak dicari. 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
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