ICLRRuntimeInfo::GetInterface 메서드

  • 아티클

업데이트: 2010년 10월

CLR을 현재 프로세스로 로드하고 ICLRRuntimeHost, ICLRStrongName 및 IMetaDataDispenser 같은 런타임 인터페이스 포인터를 반환합니다.

이 메서드는 .NET Framework 1.1 및 2.0 호스팅 전역 정적 함수 단원에서 설명하는 모든 CorBindTo* 함수를 대체합니다.

HRESULT GetInterface(
[in]  REFCLSID rclsid,
[in]  REFIID   riid,
[out, iid_is(riid), retval] LPVOID *ppUnk);

매개 변수

  • rclsid
    [in] coclass의 CLSID 인터페이스입니다.

  • riid
    [in] 요청된 rclsid 인터페이스의 IID입니다.

  • ppUnk
    [out] 쿼리된 인터페이스에 대한 포인터입니다.

반환 값

이 메서드는 메서드 오류를 나타내는 HRESULT 오류뿐만 아니라 다음과 같은 특정 HRESULT를 반환합니다.

HRESULT

설명

S_OK

메서드가 성공적으로 완료되었습니다.

E_POINTER

ppUnk이 null입니다.

E_OUTOFMEMORY

메모리가 부족하여 요청을 처리할 수 없습니다.

CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND

다른 런타임은 레거시 CLR 버전 2 활성화 정책에 이미 바인딩되었습니다.

설명

이 메서드를 사용하면 CLR이 로드되지만 초기화되지는 않습니다.

다음 표에서는 rclsid와 riid의 지원되는 조합을 보여 줍니다.

rclsid

riid

CLSID_CorMetaDataDispenser

IID_IMetaDataDispenser, IID_IMetaDataDispenserEx

CLSID_CorMetaDataDispenserRuntime

IID_IMetaDataDispenser, IID_IMetaDataDispenserEx

CLSID_CorRuntimeHost

IID_ICorRuntimeHost

CLSID_CLRRuntimeHost

IID_ICLRRuntimeHost

CLSID_TypeNameFactory

IID_ITypeNameFactory

CLSID_CLRStrongName

IID_ICLRStrongName

요구 사항

플랫폼: .NET Framework 시스템 요구 사항 참조

헤더: MetaHost.h

라이브러리: MSCorEE.dll에 리소스로 포함됨

.NET Framework 버전: 4

참고 항목

참조

ICLRRuntimeInfo 인터페이스

기타 리소스

호스팅 인터페이스

호스팅(관리되지 않는 API 참조)

변경 기록

날짜

변경 내용

이유

2010년 10월

반환 코드에 CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND를 추가했습니다.

콘텐츠 버그 수정

2010년 9월

몇 가지 riid 항목을 수정했습니다.

고객 의견

2010년 6월

CLSID_CLRRuntimeHost와 함께 사용할 수 있는 riid를 수정했습니다.

콘텐츠 버그 수정