Fungsi SymGetModuleBase (dbghelp.h)

Artikel
08/23/2023

Mengambil alamat dasar modul yang berisi alamat yang ditentukan.

Sintaks

DWORD IMAGEAPI SymGetModuleBase(
  [in] HANDLE hProcess,
  [in] DWORD  dwAddr
);

Parameter

[in] hProcess

Handel ke proses yang awalnya diteruskan ke fungsi SymInitialize .

[in] dwAddr

Alamat virtual yang terkandung dalam salah satu modul yang dimuat oleh fungsi SymLoadModule64 .

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah alamat virtual bukan nol. Nilai adalah alamat dasar modul yang berisi alamat yang ditentukan oleh parameter dwAddr .

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

Keterangan

Tabel modul dicari untuk modul yang berisi dwAddr. Modul ini terletak berdasarkan alamat beban dan ukuran setiap modul.

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

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymGetModuleBase SymGetModuleBase64
#else
DWORD
IMAGEAPI
SymGetModuleBase(
    __in HANDLE hProcess,
    __in DWORD dwAddr
    );
#endif