Fungsi SymGetSymbolFile (dbghelp.h)

Artikel
08/23/2023

Menemukan file simbol di jalur simbol yang ditentukan.

Sintaks

BOOL IMAGEAPI SymGetSymbolFile(
  [in, optional] HANDLE hProcess,
  [in, optional] PCSTR  SymPath,
  [in]           PCSTR  ImageFile,
  [in]           DWORD  Type,
  [out]          PSTR   SymbolFile,
  [in]           size_t cSymbolFile,
  [out]          PSTR   DbgFile,
  [in]           size_t cDbgFile
);

Parameter

[in, optional] hProcess

Handel ke proses yang awalnya diteruskan ke fungsi SymInitialize .

Jika handel ini adalah 0, SymPath tidak boleh NULL. Gunakan opsi ini untuk memuat file simbol tanpa memanggil SymInitialize atau SymCleanup.

[in, optional] SymPath

Jalur simbol. Jika parameter ini adalah NULL atau string kosong, fungsi menggunakan jalur simbol yang diatur menggunakan fungsi SymInitialize atau SymSetSearchPath .

[in] ImageFile

Nama file gambar.

[in] Type

Jenis file simbol. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
sfImage 0	File .exe atau .dll.
sfDbg 1	File .dbg.
sfPdb 2	File .pdb.
sfMpd 3	Dicadangkan.

[out] SymbolFile

Penunjuk ke string yang dihentikan null yang menerima nama file simbol.

[in] cSymbolFile

Ukuran buffer SymbolFile , dalam karakter.

[out] DbgFile

Penunjuk ke buffer yang menerima jalur yang sepenuhnya memenuhi syarat ke file simbol. Buffer ini setidaknya harus MAX_PATH karakter.

[in] cDbgFile

Ukuran buffer DbgFile , dalam karakter.

Nilai kembali

Jika server menemukan file simbol yang valid, server mengembalikan TRUE; jika tidak, ia mengembalikan FALSE dan GetLastError mengembalikan nilai yang menunjukkan mengapa file simbol tidak dikembalikan.

Keterangan

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


Target Platform	Windows
Header	dbghelp.h
Pustaka	Dbghelp.lib
DLL	Dbghelp.dll
Redistribusi	DbgHelp.dll 6.3 atau yang lebih baru

Lihat juga

DbgHelp Functions

SymInitialize

Bagikan melalui