다음을 통해 공유

ICorDebugMetaDataLocator::GetMetaData 메서드

  • 아티클

디버거가 요청한 작업을 완료하는 데 필요한 메타데이터가 포함된 모듈의 전체 경로를 반환하도록 디버거에 요청합니다.

구문

HRESULT GetMetaData(
      [in] LPCWSTR wszImagePath,
      [in] DWORD   dwImageTimeStamp,
      [in] DWORD   dwImageSize,
      [in] ULONG32 cchPathBuffer,
      [out] ULONG32 * pcchPathBuffer,
      [out, size_is(cchPathBuffer), length_is(*pcchPathBuffer)]
               WCHAR wszPathBuffer[]
      );

매개 변수

wszImagePath [in] 파일의 전체 경로를 나타내는 null로 끝나는 문자열입니다. 전체 경로가 제공되지 않을 경우에는 파일의 이름과 확장명입니다(filename.extension).

dwImageTimeStamp [in] 이미지의 PE 파일 헤더에서 타임스탬프를 가져옵니다. 이 매개 변수는 symbol 서버(SymSrv) 조회에 사용될 수 있습니다.

dwImageSize [in] PE 파일 헤더의 이미지 크기입니다. 이 매개 변수는 SymSrv 조회에 사용될 수 있습니다.

cchPathBuffer [in] 의 문자 수입니다 wszPathBuffer.

pcchPathBuffer [out] 에 기록된 s의 WCHAR수입니다 wszPathBuffer.

메서드가 E_NOT_SUFFICIENT_BUFFER를 반환할 경우 경로를 저장하는 데 필요한 WCHAR 개수가 포함됩니다.

wszPathBuffer [out] 디버거가 요청된 메타데이터를 포함하는 파일의 전체 경로를 복사할 버퍼에 대한 포인터입니다.

CorOpenFlags 열거형의 ofReadOnly 플래그는 이 파일의 메타데이터에 대한 읽기 전용 액세스를 요청하는 데 사용됩니다.

Return Value

이 메서드는 다음과 같은 특정 HRESULT뿐만 아니라 메서드 오류를 나타내는 HRESULT 오류도 반환합니다. 모든 기타 오류 HRESULT는 파일을 검색할 수 없음을 의미합니다.

HRESULT 설명
S_OK 메서드가 완료되었습니다. wszPathBuffer는 파일의 전체 경로를 포함하고 null로 종료됩니다.
E_NOT_SUFFICIENT_BUFFER wszPathBuffer의 현재 크기는 전체 경로를 포함하기에 충분하지 않습니다. 이 경우 pcchPathBuffer는 종료 null 문자를 비롯하여 필요한 WCHAR 개수를 포함하고, GetMetaData는 요청된 버퍼 크기와 함께 두 번째로 호출됩니다.

설명

wszImagePath에 덤프부터 모듈의 전체 경로가 포함되면 이 매개 변수는 덤프가 수집된 컴퓨터의 경로를 지정합니다. 이 위치에 파일이 있을 수 없거나 같은 이름을 가진 잘못된 파일이 경로에 저장될 수 있습니다.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: CorDebug.idl, CorDebug.h

라이브러리: CorGuids.lib

.NET Framework 버전: 4부터 사용 가능

참고 항목