Fungsi SymRegisterFunctionEntryCallback (dbghelp.h)

Artikel
08/23/2023

Mendaftarkan fungsi panggilan balik untuk digunakan oleh prosedur berjalan tumpukan di komputer Alpha.

Sintaks

BOOL IMAGEAPI SymRegisterFunctionEntryCallback(
  [in] HANDLE                     hProcess,
  [in] PSYMBOL_FUNCENTRY_CALLBACK CallbackFunction,
  [in] PVOID                      UserContext
);

Parameter

[in] hProcess

Handel ke proses yang awalnya diteruskan ke fungsi StackWalk64 .

[in] CallbackFunction

Fungsi panggilan balik SymRegisterFunctionEntryCallbackProc64 .

[in] UserContext

Nilai yang ditentukan pengguna atau NULL. Nilai ini hanya diteruskan ke fungsi panggilan balik. Biasanya, parameter ini digunakan oleh aplikasi untuk meneruskan penunjuk 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 SymRegisterFunctionEntryCallback64 memungkinkan aplikasi mendaftarkan fungsi panggilan balik untuk digunakan oleh prosedur berjalan tumpukan. Prosedur berjalan tumpukan memanggil fungsi panggilan balik terdaftar ketika tidak dapat menemukan entri tabel fungsi untuk alamat. Dalam kebanyakan kasus, prosedur berjalan tumpukan menemukan entri tabel fungsi dalam tabel fungsi gambar yang berisi alamat. Namun, dalam situasi di mana entri tabel fungsi tidak ada dalam gambar, panggilan balik ini memungkinkan debugger untuk menyediakan entri tabel fungsi dari sumber lain. Misalnya, kode yang dihasilkan run-time pada komputer Alpha dapat menentukan tabel fungsi dinamis untuk mendukung penanganan pengecualian dan pelacakan tumpukan.

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.

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

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymRegisterFunctionEntryCallback SymRegisterFunctionEntryCallback64
#else
BOOL
IMAGEAPI
SymRegisterFunctionEntryCallback(
    __in HANDLE hProcess,
    __in PSYMBOL_FUNCENTRY_CALLBACK CallbackFunction,
    __in_opt PVOID UserContext
    );
#endif