Fungsi SymGetSymFromAddr (dbghelp.h)
Menemukan simbol untuk alamat yang ditentukan.
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
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | dbghelp.h |
Pustaka | Dbghelp.lib |
DLL | Dbghelp.dll |
Redistribusi | DbgHelp.dll 5.1 atau yang lebih baru |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk