다음을 통해 공유


ICorDebugMetaDataLocator::GetMetaData 메서드

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

Syntax

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로 끝나는 문자열입니다. 전체 경로를 사용할 수 없는 경우 파일의 이름 및 확장명(파일 이름)입니다.확장).

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

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

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

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

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

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

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

반환 값

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

HRESULT Description
S_OK 메서드가 성공적으로 완료되었습니다. wszPathBuffer 에는 파일의 전체 경로가 포함되어 있으며 null로 종료됩니다.
E_NOT_SUFFICIENT_BUFFER 현재 크기 wszPathBuffer 가 전체 경로를 보유하기에 충분하지 않습니다. 이 경우 pcchPathBuffer 종료 null 문자를 포함하여 필요한 s 수를 WCHAR포함하며 GetMetaData 요청된 버퍼 크기를 사용하여 두 번째로 호출됩니다.

비고

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

요구 사항

플랫폼:.NET 지원 운영 체제를 참조하세요.

머리글: CorDebug.idl, CorDebug.h

도서관: CorGuids.lib

.NET 버전: .NET Framework 4.0 이후 사용 가능

참고하십시오