Поделиться через

Метод IDebugHostModule::GetImageName (dbgmodel.h)

  • Статья

Метод GetImageName возвращает имя образа модуля. В зависимости от значения аргумента allowPath возвращаемое имя образа может содержать полный путь к изображению.

Синтаксис

HRESULT GetImageName(
  bool allowPath,
  BSTR *imageName
);

Параметры

allowPath

Если значение равно true, указывает, что в выходные данные может быть включен полный путь к модулю. Указывает, включен ли такой путь, зависит от конкретного узла отладки и способа загрузки модуля. Значение false указывает, что в выходные данные будет включено только имя образа модуля.

imageName

Имя образа (или полный путь) модуля будет возвращено здесь в виде выделенной строки. Вызывающий объект отвечает за вызов SysFreeString для освобождения строки после использования.

Возвращаемое значение

Этот метод возвращает HRESULT, который указывает на успех или сбой.

Комментарии

Образец кода

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);
}

Требования

Требование Значение
Заголовок dbgmodel.h

См. также раздел

Интерфейс IDebugHostModule