ICLRMetaHost::GetRuntime 메서드

  • 아티클

CLR(공용 언어 런타임)의 특정 버전에 해당하는 ICLRRuntimeInfo 인터페이스를 가져옵니다. 이 메서드는 STARTUP_LOADER_SAFEMODE 플래그와 함께 사용되는 CorBindToRuntimeEx 함수를 대체합니다.

구문

HRESULT GetRuntime (  
    [in] LPCWSTR pwzVersion,  
    [in] REFIID riid,  
    [out,iid_is(riid), retval] LPVOID *ppRuntime  
);

매개 변수

pwzVersion
[in] 메타데이터에 저장된 .NET Framework 컴파일 버전("vA.B[.X]") A, B 및 X는 주 버전, 부 버전 및 빌드 번호에 해당하는 10진수입니다.

참고

이 매개 변수는 C:\Windows\Microsoft.NET\Framework 또는 C:\Windows\Microsoft.NET\Framework64 아래에 표시되므로 .NET Framework 버전의 디렉터리 이름과 일치해야 합니다.

예제 값은 "v1.0.3705", "v1.1.4322", "v2.0.50727" 및 "v4.0.X"입니다. 여기서 X는 설치된 빌드 번호에 따라 달라집니다. “v” 접두사는 필수입니다.

riid
[in] 원하는 인터페이스의 식별자입니다. 현재 이 매개 변수에 유효한 값은 IID_ICLRRuntimeInfo입니다.

ppRuntime
[out] 요청된 런타임에 해당하는 ICLRRuntimeInfo 인터페이스에 대한 포인터입니다.

Return Value

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

HRESULT 설명
S_OK 메서드가 완료되었습니다.
E_POINTER pwzVersion 또는 ppRuntime가 null입니다.

설명

이 메서드는 ICorRuntimeHost 인터페이스와 같은 레거시 인터페이스 및 사용되지 않는 CorBindTo* 함수와 같은 레거시 함수와 일관되게 상호 작용합니다(.NET Framework 2.0 호스팅 API에서 사용되지 않는 CLR 호스팅 함수 참조). 즉, 레거시 API와 함께 로드된 런타임은 새 API에 표시되고, 새 API와 함께 로드된 런타임은 레거시 API에 표시됩니다.

요구 사항

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

헤더: MetaHost.h

라이브러리: 리소스로 MSCorEE.dll에 포함됩니다.

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

참고 항목