Fungsi FindDebugInfoFile (dbghelp.h)

Artikel
02/29/2024

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.