IDebugSymbols3::GetModuleByOffset method (dbgeng.h)

Artikel
02/26/2024

Metode GetModuleByOffset mencari modul target untuk modul yang alokasi memorinya mencakup lokasi yang ditentukan.

Sintaks

HRESULT GetModuleByOffset(
  [in]            ULONG64  Offset,
  [in]            ULONG    StartIndex,
  [out, optional] PULONG   Index,
  [out, optional] PULONG64 Base
);

Parameter

[in] Offset

Menentukan lokasi di ruang alamat virtual target yang berada di dalam alokasi memori modul yang diinginkan -- misalnya, alamat simbol milik modul.

[in] StartIndex

Menentukan indeks untuk mulai mencari.

[out, optional] Index

Menerima indeks modul. Jika IndeksNULL, informasi ini tidak dikembalikan.

[out, optional] Base

Menerima lokasi di ruang alamat memori target dari dasar modul. Jika BasisNULL, informasi ini tidak dikembalikan.

Nilai kembali

Metode ini juga dapat mengembalikan nilai kesalahan. Lihat Mengembalikan Nilai untuk detail selengkapnya.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Mulai dari indeks yang ditentukan, metode ini mengembalikan modul pertama yang ditemukan yang rentang alamat alokasi memorinya mencakup lokasi yang ditentukan. Jika target memiliki lebih dari satu modul yang rentang alamat memorinya mencakup lokasi ini, maka modul berikutnya dapat ditemukan dengan panggilan berulang ke metode ini dengan nilai StartIndex yang lebih tinggi.

Untuk informasi selengkapnya tentang modul, lihat Modul.