Метод 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