Metode IDebugSymbols3::GetModuleByModuleName (dbgeng.h)

Artikel
02/26/2024

Metode GetModuleByModuleName mencari melalui modul target untuk satu dengan nama yang ditentukan.

Sintaks

HRESULT GetModuleByModuleName(
  [in]            PCSTR    Name,
  [in]            ULONG    StartIndex,
  [out, optional] PULONG   Index,
  [out, optional] PULONG64 Base
);

Parameter

[in] Name

Menentukan nama modul yang diinginkan.

[in] StartIndex

Menentukan indeks untuk mulai mencari.

[out, optional] Index

Menerima indeks modul pertama dengan nama Nama. 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 lainnya. Lihat Mengembalikan Nilai untuk detail selengkapnya.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Salah satu argumen yang diteruskan tidak valid.

Keterangan

Mulai dari indeks yang ditentukan, metode ini mengembalikan modul pertama yang mereka temukan dengan nama yang ditentukan. Jika target memiliki lebih dari satu modul dengan nama 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.