Bagikan melalui


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

Lihat juga

Antarmuka IDebugHostModule