Fungsi SymRegisterCallback (dbghelp.h)

Artikel
02/28/2024

Mendaftarkan fungsi panggilan balik untuk digunakan oleh penangan simbol.

Sintaks

BOOL IMAGEAPI SymRegisterCallback(
  [in] HANDLE                      hProcess,
  [in] PSYMBOL_REGISTERED_CALLBACK CallbackFunction,
  [in] PVOID                       UserContext
);

Parameter

[in] hProcess

Handel ke proses yang awalnya diteruskan ke fungsi SymInitialize .

[in] CallbackFunction

Fungsi panggilan balik SymRegisterCallbackProc64 .

[in] UserContext

Nilai yang ditentukan pengguna atau NULL. Nilai ini hanya diteruskan ke fungsi panggilan balik. Biasanya, parameter ini digunakan oleh aplikasi untuk meneruskan pointer ke struktur data yang memungkinkan fungsi panggilan balik menetapkan beberapa konteks.

Nilai kembali

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 SymRegisterCallback64 memungkinkan aplikasi mendaftarkan fungsi panggilan balik untuk digunakan oleh penangan simbol. Penangan simbol memanggil fungsi panggilan balik terdaftar ketika ada informasi status atau kemajuan untuk aplikasi.

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. SymRegisterCallbackW64 didefinisikan sebagai berikut dalam Dbghelp.h.

BOOL
IMAGEAPI
SymRegisterCallbackW64(
    __in HANDLE hProcess,
    __in PSYMBOL_REGISTERED_CALLBACK64 CallbackFunction,
    __in ULONG64 UserContext
    );

#ifdef DBGHELP_TRANSLATE_TCHAR
#define SymRegisterCallback64   SymRegisterCallbackW64
#endif

Fungsi ini menggantikan fungsi SymRegisterCallback . Untuk informasi selengkapnya, lihat Dukungan Platform yang Diperbarui. SymRegisterCallback didefinisikan sebagai berikut dalam Dbghelp.h.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymRegisterCallback SymRegisterCallback64
#else
BOOL
IMAGEAPI
SymRegisterCallback(
    __in HANDLE hProcess,
    __in PSYMBOL_REGISTERED_CALLBACK CallbackFunction,
    __in_opt PVOID UserContext
    );
#endif

Untuk contoh yang lebih luas, baca Mendapatkan Pemberitahuan.