Metode IDebugSymbols3::GetModuleNameString (dbgeng.h)

Artikel
02/23/2024

Metode GetModuleNameString mengembalikan nama modul yang ditentukan.

Sintaks

HRESULT GetModuleNameString(
  [in]            ULONG   Which,
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [out, optional] PSTR    Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  NameSize
);

Parameter

[in] Which

Menentukan nama modul mana yang akan dikembalikan, nilai yang mungkin adalah:

Nilai	Deskripsi
DEBUG_MODNAME_IMAGE	Nama gambar. Ini adalah nama file yang dapat dieksekusi, termasuk ekstensi. Biasanya, jalur lengkap disertakan dalam mode pengguna tetapi tidak dalam mode kernel.
DEBUG_MODNAME_MODULE	Nama modul. Ini biasanya hanya nama file tanpa ekstensi. Dalam beberapa kasus, nama modul berbeda secara signifikan dari nama file.
DEBUG_MODNAME_LOADED_IMAGE	Nama gambar yang dimuat. Kecuali simbol Microsoft CodeView ada, ini sama dengan nama gambar.
DEBUG_MODNAME_SYMBOL_FILE	Nama file simbol. Jalur dan nama file simbol. Jika tidak ada simbol yang dimuat, ini adalah nama file yang dapat dieksekusi sebagai gantinya.
DEBUG_MODNAME_MAPPED_IMAGE	Nama gambar yang dipetakan. Dalam kebanyakan kasus, ini adalah NULL. Jika debugger memetakan file gambar (misalnya, selama debugging minidump), ini adalah nama gambar yang dipetakan.

[in] Index

Menentukan indeks modul. Jika diatur ke DEBUG_ANY_ID, parameter Dasar digunakan untuk menentukan lokasi modul sebagai gantinya.

[in] Base

Jika Indeks DEBUG_ANY_ID, menentukan lokasi di ruang alamat memori target dari dasar modul. Jika tidak, itu diabaikan.

[out, optional] Buffer

Menerima nama modul. Jika BufferNULL, informasi ini tidak dikembalikan.

[in] BufferSize

Menentukan ukuran dalam karakter buffer Buffer. Ukuran ini mencakup ruang untuk karakter '\0' yang mengakhiri.

[out, optional] NameSize

Menerima ukuran dalam karakter nama modul. Ukuran ini mencakup ruang untuk karakter '\0' yang mengakhiri. Jika NameSizeNULL, 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.
S_FALSE	Metode berhasil. Namun, ukuran buffer lebih kecil dari ukuran nama modul sehingga terpotok agar pas di buffer.

Keterangan

Untuk informasi selengkapnya tentang modul, lihat Modul.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	dbgeng.h (termasuk Dbgeng.h)

Lihat juga

GetModuleNames

IDebugSymbols2

IDebugSymbols3