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

요구 사항

추가 정보

IDebugHostModule 인터페이스