Fungsi SymGetSymFromAddr (dbghelp.h)

Artikel
02/28/2024

Menemukan simbol untuk alamat yang ditentukan.

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

Sintaks

BOOL IMAGEAPI SymGetSymFromAddr(
  [in]            HANDLE           hProcess,
  [in]            DWORD            dwAddr,
  [out, optional] PDWORD           pdwDisplacement,
  [in, out]       PIMAGEHLP_SYMBOL Symbol
);

Parameter

[in] hProcess

Handel ke proses yang awalnya diteruskan ke fungsi SymInitialize .

[in] dwAddr

Alamat tempat simbol berada. Alamat tidak harus berada di batas simbol. Jika alamat muncul setelah awal simbol dan sebelum akhir simbol (awal simbol ditambah ukuran simbol), simbol ditemukan.

[out, optional] pdwDisplacement

Perpindahan dari awal simbol, atau nol.

[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 SymGetSymFromAddr64 menemukan simbol untuk alamat tertentu. Modul dicari untuk salah satu alamat miliknya. Saat modul ditemukan, tabel simbolnya dicari untuk kecocokan. Ketika simbol ditemukan, informasi simbol disalin ke dalam buffer Simbol yang disediakan oleh pemanggil. Pemanggil harus mengalokasikan buffer Simbol dengan benar dan mengisi parameter yang diperlukan dalam struktur IMAGEHLP_SYMBOL64 sebelum memanggil SymGetSymFromAddr64.

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 SymGetSymFromAddr . Untuk informasi selengkapnya, lihat Dukungan Platform yang Diperbarui. SymGetSymFromAddr didefinisikan sebagai berikut dalam Dbghelp.h.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymGetSymFromAddr SymGetSymFromAddr64
#else
BOOL
IMAGEAPI
SymGetSymFromAddr(
    __in HANDLE hProcess,
    __in DWORD dwAddr,
    __out_opt PDWORD pdwDisplacement,
    __inout PIMAGEHLP_SYMBOL Symbol
    );
#endif