Metode IDebugSymbols3::GetModuleByOffset2 (dbgeng.h)

Artikel
02/23/2024

Metode GetModuleByOffset2 mencari modul proses untuk modul yang alokasi memorinya mencakup lokasi yang ditentukan.

Sintaks

HRESULT GetModuleByOffset2(
  [in]            ULONG64  Offset,
  [in]            ULONG    StartIndex,
  [in]            ULONG    Flags,
  [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.

[in] Flags

Menentukan set bit yang berisi opsi yang digunakan saat mencari modul dengan lokasi yang ditentukan. Bendera mungkin berisi bendera bit berikut:

Bendera	Efek
DEBUG_GETMOD_NO_LOADED_MODULES	Jangan mencari modul yang dimuat.
DEBUG_GETMOD_NO_UNLOADED_MODULES	Jangan mencari modul yang tidak dimuat.

[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.