Metode IDebugHostModule::GetImageName (dbgmodel.h)
Metode GetImageName mengembalikan nama gambar modul. Bergantung pada nilai argumen allowPath, nama gambar yang dikembalikan mungkin atau mungkin tidak menyertakan jalur lengkap ke gambar.
Sintaks
HRESULT GetImageName(
bool allowPath,
BSTR *imageName
);
Parameter
allowPath
Jika true, menunjukkan bahwa jalur lengkap ke modul dapat disertakan dalam output. Apakah jalur tersebut atau tidak disertakan hingga host debug tertentu dan cara di mana modul dimuat. Jika false, menunjukkan bahwa hanya nama gambar modul yang akan disertakan dalam output.
imageName
Nama gambar (atau jalur lengkap) modul akan dikembalikan di sini sebagai string yang dialokasikan. Pemanggil bertanggung jawab untuk memanggil SysFreeString untuk membebaskan string setelah digunakan.
Nilai kembali
Metode ini mengembalikan HRESULT yang menunjukkan keberhasilan atau kegagalan.
Keterangan
Kode Sampel
ComPtr<IDebugHostModule> spModule; /* get a module (see FindModuleByName) */
BSTR imageName;
if (SUCCEEDED(spModule->GetImageName(false, &imageName)))
{
// imageName is the name of the image (guaranteed not to have a path
// in it). For instance, this might be "notepad.exe"
SysFreeString(imageName);
}
Persyaratan
Persyaratan | Nilai |
---|---|
Header | dbgmodel.h |