다음을 통해 공유

IDiaDataSource::loadDataForExe

  • 아티클

.exe/.dll 파일과 연결된 디버그 데이터를 열고 준비합니다.

구문

HRESULT loadDataForExe (
   LPCOLESTR executable,
   LPCOLESTR searchPath,
   IUnknown* pCallback
);

매개 변수

executable

[in] .exe 또는 .dll 파일의 경로입니다.

searchPath

[in] 디버그 데이터를 검색할 대체 경로입니다.

pCallback

[in] IDiaLoadCallback, IDiaLoadCallback2, IDiaReadExeAtOffsetCallback 및/또는 IDiaReadExeAtRVACallback 인터페이스와 같이 디버그 콜백 인터페이스를 지원하는 개체의 IUnknown 인터페이스입니다.

Return Value

성공하면 S_OK를 반환하고, 실패하면 오류 코드를 반환합니다. 다음 표에서는 이 메서드에 대해 가능한 오류 코드 중 일부를 보여 줍니다.

값 설명
E_PDB_NOT_FOUND 파일을 열지 못했거나 파일 형식이 잘못되었습니다.
E_PDB_FORMAT 사용되지 않는 형식의 파일에 액세스하려고 했습니다.
E_PDB_INVALID_SIG 시그니처가 일치하지 않습니다.
E_PDB_INVALID_AGE 보존 기간이 일치하지 않습니다.
E_INVALIDARG 잘못된 매개 변수입니다.
E_UNEXPECTED 데이터 소스가 이미 준비되었습니다.

설명

.exe/.dll 파일의 디버그 헤더는 연결된 디버그 데이터 위치의 이름을 지정합니다.

기호 서버 에서 디버그 데이터를 로드하는 경우 symsrv.dll 사용자의 애플리케이션 또는 msdia140.dll 설치되어 있거나 시스템 디렉터리에 있어야 하는 동일한 디렉터리에 있어야 합니다.

이 메서드는 디버그 헤더를 읽은 다음, 디버그 데이터를 검색하고 준비합니다. 필요에 따라 콜백을 통해 검색 진행 상황을 보고하고 제어할 수 있습니다. 예를 들어, IDiaLoadCallback::NotifyDebugDir은 IDiaDataSource::loadDataForExe 메서드가 디버그 디렉터리를 찾고 처리할 때 호출됩니다.

IDiaReadExeAtOffsetCallback 및 IDiaReadExeAtRVACallback 인터페이스를 사용하면 표준 파일 I/O를 통해 파일에 직접 액세스할 수 없는 경우 클라이언트 애플리케이션은 실행 파일에서 데이터를 읽는 대체 메서드를 제공할 수 있습니다.

유효성 검사 없이 .pdb 파일을 로드하려면 IDiaDataSource::loadDataFromPdb 메서드를 사용합니다.

특정 조건에 대해 .pdb 파일의 유효성을 검사하려면 IDiaDataSource::loadAndValidateDataFromPdb 메서드를 사용합니다.

메모리에서 직접 .pdb 파일을 로드하려면 IDiaDataSource::loadDataFromIStream 메서드를 사용합니다.

예시

class MyCallBack: public IDiaLoadCallback
{
...
};
MyCallBack callback;
...
HRESULT hr = pSource->loadDataForExe( L"myprog.exe", L".\debug", (IUnknown*)&callback);
if (FAILED(hr))
{
    // Report error
}

참고 항목