Fungsi SymFindDebugInfoFile (dbghelp.h)

Menemukan file .dbg di jalur pencarian proses.

Syntax

HANDLE IMAGEAPI SymFindDebugInfoFile(
  [in]           HANDLE                    hProcess,
  [in]           PCSTR                     FileName,
  [out]          PSTR                      DebugFilePath,
  [in, optional] PFIND_DEBUG_FILE_CALLBACK Callback,
  [in, optional] PVOID                     CallerData
);

Parameters

[in] hProcess

Handel ke proses yang awalnya diteruskan ke fungsi SymInitialize .

[in] FileName

Nama file .dbg. Anda dapat menggunakan jalur parsial.

[out] DebugFilePath

Jalur file .dbg yang sepenuhnya memenuhi syarat. Buffer ini setidaknya harus MAX_PATH+1 karakter.

[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 dapat null.

[in, optional] 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 pengembalian adalah handel terbuka ke file .dbg.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Fungsi ini menggunakan set jalur pencarian menggunakan fungsi SymInitialize atau SymSetSearchPath .

Semua fungsi DbgHelp, seperti yang ini, berutas 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
Platform Target	Windows
Header	dbghelp.h
Library	Dbghelp.lib
DLL	Dbghelp.dll
Dapat didistribusikan ulang	DbgHelp.dll 6.6 atau yang lebih baru

Baca juga

Fungsi DbgHelp

FindDebugInfoFileProc