Metode IDebugSymbols3::GetModuleNameString (dbgeng.h)
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 |
---|---|
|
Metode berhasil. |
|
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) |