Metode IDebugSymbols::GetModuleNames (dbgeng.h)

Artikel
08/07/2023

Metode GetModuleNames mengembalikan nama modul yang ditentukan.

Sintaks

HRESULT GetModuleNames(
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [out, optional] PSTR    ImageNameBuffer,
  [in]            ULONG   ImageNameBufferSize,
  [out, optional] PULONG  ImageNameSize,
  [out, optional] PSTR    ModuleNameBuffer,
  [in]            ULONG   ModuleNameBufferSize,
  [out, optional] PULONG  ModuleNameSize,
  [out, optional] PSTR    LoadedImageNameBuffer,
  [in]            ULONG   LoadedImageNameBufferSize,
  [out, optional] PULONG  LoadedImageNameSize
);

Parameter

[in] Index

Menentukan indeks modul yang namanya diminta. Jika diatur ke DEBUG_ANY_ID, modul ditentukan oleh Base.

[in] Base

Menentukan alamat dasar modul yang namanya diminta. Parameter ini hanya digunakan jika Indeks diatur ke DEBUG_ANY_ID.

[out, optional] ImageNameBuffer

Menerima nama gambar modul. Jika ImageNameBufferNULL, informasi ini tidak dikembalikan.

[in] ImageNameBufferSize

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

[out, optional] ImageNameSize

Menerima ukuran dalam karakter nama gambar. Ukuran ini mencakup ruang untuk karakter yang mengakhiri '\0'. Jika ImageNameSizeNULL, informasi ini tidak dikembalikan.

[out, optional] ModuleNameBuffer

Menerima nama modul modul. Jika ModuleNameBufferADALAH NULL, informasi ini tidak dikembalikan.

[in] ModuleNameBufferSize

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

[out, optional] ModuleNameSize

Menerima ukuran dalam karakter nama modul. Ukuran ini mencakup ruang untuk karakter yang mengakhiri '\0'. Jika ModuleNameSizeNULL, informasi ini tidak dikembalikan.

[out, optional] LoadedImageNameBuffer

Menerima nama gambar modul yang dimuat. Jika LoadedImageNameBufferADALAH NULL, informasi ini tidak dikembalikan.

[in] LoadedImageNameBufferSize

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

[out, optional] LoadedImageNameSize

Menerima ukuran dalam karakter nama gambar yang dimuat. Ukuran ini mencakup ruang untuk karakter yang mengakhiri '\0'. Jika LoadedImageNameSizeADALAH NULL, 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.
S_FALSE	Metode berhasil. Namun, setidaknya salah satu ImageNameBuffer, ModuleNameBuffer, atau LoadedImageNameBuffer terlalu kecil untuk nama yang sesuai, sehingga terpotong.
E_NOINTERFACE	Modul yang ditentukan tidak ditemukan.