Fungsi SymFromAddrW (dbghelp.h)

Artikel
11/20/2024

Mengambil informasi simbol untuk alamat yang ditentukan.

Sintaksis

BOOL IMAGEAPI SymFromAddrW(
  [in]            HANDLE        hProcess,
  [in]            DWORD64       Address,
  [out, optional] PDWORD64      Displacement,
  [in, out]       PSYMBOL_INFOW Symbol
);

Parameter

[in] hProcess

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

[in] Address

Alamat tempat simbol harus berada. Alamat tidak harus berada pada batas simbol. Jika alamat datang setelah awal simbol dan sebelum akhir simbol, simbol ditemukan.

[out, optional] Displacement

Perpindahan dari awal simbol, atau nol.

[in, out] Symbol

Penunjuk ke struktur SYMBOL_INFO yang menyediakan informasi tentang simbol. Panjang nama simbol adalah variabel; oleh karena itu buffer ini harus cukup besar untuk menahan nama yang disimpan di akhir struktur SYMBOL_INFO. Pastikan untuk mengatur anggota MaxNameLen ke jumlah byte yang dicadangkan untuk nama tersebut.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian TRUE.

Jika fungsi gagal, nilai yang dikembalikan adalah FALSE. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Semua fungsi DbgHelp, seperti yang ini, berutas 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.

Contoh

Misalnya, lihat Mengambil Informasi Simbol berdasarkan Alamat.

Nota

Header dbghelp.h mendefinisikan SymFromAddr sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
Platform Target	Windows
Header	dbghelp.h
Pustaka	Dbghelp.lib
DLL	Dbghelp.dll
Redistributable	DbgHelp.dll 5.1 atau yang lebih baru

Lihat juga

DbgHelp Functions

SYMBOL_INFO

Bagikan melalui