Fungsi FindDebugInfoFileEx (dbghelp.h)

Artikel
08/23/2023

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

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 5.1 atau yang lebih baru

Lihat juga

DbgHelp Functions

FindDebugInfoFileProc

SymGetSearchPath

Bagikan melalui