Fungsi SymGetSymNext (dbghelp.h)

Artikel
02/28/2024

Mengambil informasi simbol untuk simbol berikutnya.

Catatan Fungsi ini disediakan hanya untuk kompatibilitas. Aplikasi harus menggunakan SymNext.

Sintaks

BOOL IMAGEAPI SymGetSymNext(
  [in]      HANDLE           hProcess,
  [in, out] PIMAGEHLP_SYMBOL Symbol
);

Parameter

[in] hProcess

Handel ke proses yang awalnya diteruskan ke fungsi SymInitialize .

[in, out] Symbol

Penunjuk ke struktur IMAGEHLP_SYMBOL64 .

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 SymGetSymNext64 mengharuskan struktur IMAGEHLP_SYMBOL64 memiliki data yang valid, mungkin diperoleh dari panggilan ke fungsi SymGetSymFromAddr64 atau SymGetSymFromName64 . Struktur ini diisi dengan informasi simbol untuk simbol berikutnya secara berurutan menurut alamat virtual.

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. SymGetSymNextW64 didefinisikan sebagai berikut dalam DbgHelp.h.

BOOL
IMAGEAPI
SymGetSymNextW64(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_SYMBOLW64 Symbol
    );

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

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymGetSymNext SymGetSymNext64
#define SymGetSymNextW SymGetSymNextW64
#else
BOOL
IMAGEAPI
SymGetSymNext(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_SYMBOL Symbol
    );

BOOL
IMAGEAPI
SymGetSymNextW(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_SYMBOLW Symbol
    );
#endif