Fungsi SymGetSymPrev (dbghelp.h)

Artikel
08/23/2023

Mengambil informasi simbol untuk simbol sebelumnya.

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

Sintaks

BOOL IMAGEAPI SymGetSymPrev(
  [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 .

Mengembalikan nilai

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 SymGetSymPrev64 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 sebelumnya secara berurutan berdasarkan 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. SymGetSymPrevW64 didefinisikan sebagai berikut dalam DbgHelp.h.

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

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

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymGetSymPrev SymGetSymPrev64
#define SymGetSymPrevW SymGetSymPrevW64
#else
BOOL
IMAGEAPI
SymGetSymPrev(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_SYMBOL Symbol
    );

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