ICLRMetaHost::GetRuntime 메서드

아티클
08/09/2011

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

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

매개 변수

pwzVersion
[in] 메타데이터에 "vA.B[.X]" 형식으로 저장되는 .NET Framework 컴파일 버전입니다. 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 인터페이스에 대한 포인터입니다.

반환 값

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

HRESULT	설명
S_OK	메서드가 성공적으로 완료되었습니다.
E_POINTER	pwzVersion 또는 ppRuntime이 null입니다.

설명

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