Fungsi SymNext (dbghelp.h)

Artikel
02/28/2024

Mengambil informasi simbol untuk simbol berikutnya.

Sintaks

BOOL IMAGEAPI SymNext(
  [in]      HANDLE       hProcess,
  [in, out] PSYMBOL_INFO si
);

Parameter

[in] hProcess

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

[in, out] si

Penunjuk ke struktur SYMBOL_INFO yang menyediakan informasi tentang simbol saat ini. Setelah kembali, struktur berisi informasi tentang simbol berikutnya.

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 ini mengharuskan struktur SYMBOL_INFO memiliki data yang valid untuk simbol saat ini. Simbol berikutnya adalah simbol dengan alamat virtual yang berikutnya dalam urutan.

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.