Fungsi SymSrvGetSupplement (dbghelp.h)

Mengambil file yang ditentukan dari suplemen untuk penyimpanan simbol.

Sintaks

PCSTR IMAGEAPI SymSrvGetSupplement(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  SymPath,
  [in]           PCSTR  Node,
  [in]           PCSTR  File
);

Parameter

[in] hProcess

Handel ke proses. Handel ini sebelumnya harus diteruskan ke fungsi SymInitialize .

[in, optional] SymPath

Jalur simbol. Fungsi ini hanya menggunakan penyimpanan simbol yang dijelaskan dalam sintaks standar untuk penyimpanan simbol. Semua jalur lainnya diabaikan. Jika parameter ini adalah NULL, fungsi menggunakan jalur simbol yang diatur menggunakan fungsi SymInitialize atau SymSetSearchPath .

[in] Node

File simbol yang terkait dengan file tambahan.

[in] File

Nama file.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah jalur yang sepenuhnya memenuhi syarat untuk file tambahan.

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

Keterangan

Untuk informasi selengkapnya tentang file tambahan, lihat SymSrvStoreSupplement.

Fungsi ini mengembalikan penunjuk ke buffer yang mungkin digunakan kembali oleh fungsi lain. Oleh karena itu, pastikan untuk segera menyalin data yang dikembalikan ke buffer lain.

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

Lihat juga

DbgHelp Functions

SymSrvStoreSupplement