Fungsi SymGetSearchPath (dbghelp.h)

Artikel
08/23/2023

Mengambil jalur pencarian simbol untuk proses yang ditentukan.

Sintaks

BOOL IMAGEAPI SymGetSearchPath(
  [in]  HANDLE hProcess,
  [out] PSTR   SearchPath,
  [in]  DWORD  SearchPathLength
);

Parameter

[in] hProcess

Handel ke proses yang awalnya diteruskan ke fungsi SymInitialize .

[out] SearchPath

Penunjuk ke buffer yang menerima jalur pencarian simbol.

[in] SearchPathLength

Ukuran buffer SearchPath , dalam karakter.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE.

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

Keterangan

Fungsi SymGetSearchPath menyalin jalur pencarian simbol untuk proses yang ditentukan ke dalam buffer SearchPath . Jika fungsi gagal, konten buffer tidak terdefinisi.

Untuk menentukan jalur pencarian simbol untuk proses, gunakan fungsi SymSetSearchPath .

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.