다음을 통해 공유


ICLRMetaHost 인터페이스

업데이트: 2010년 9월

버전 번호를 기반으로 특정 버전의 CLR(공용 언어 런타임)을 반환하고, 설치된 모든 CLR을 나열하고, 지정된 프로세스에 로드된 모든 런타임을 나열하고, 어셈블리를 컴파일하는 데 사용되는 CLR 버전을 검색하고, 정상적인 런타임 종료로 프로세스를 종료하며 레거시 API 바인딩을 쿼리하는 메서드를 제공합니다.

메서드

메서드

설명

ICLRMetaHost::EnumerateInstalledRuntimes 메서드

컴퓨터에 설치된 각 CLR 버전에 대한 유효한 ICLRRuntimeInfo 인터페이스 포인터를 포함하는 열거형을 반환합니다.

ICLRMetaHost::EnumerateLoadedRuntimes 메서드

주어진 프로세스에 로드되는 각 CLR에 대한 유효한 ICLRRuntimeInfo 인터페이스 포인터를 포함하는 열거를 반환합니다. 이 메서드는 GetVersionFromProcess를 대체합니다.

ICLRMetaHost::ExitProcess 메서드

모든 로드된 런타임을 정상적으로 종료한 다음 프로세스를 종료합니다. CorExitProcess 함수를 대체합니다.

ICLRMetaHost::GetRuntime 메서드

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

ICLRMetaHost::GetVersionFromFile 메서드

해당 파일 경로가 지정된 어셈블리의 원래 .NET Framework 컴파일 버전(메타데이터에 저장됨)을 가져옵니다. 이 메서드는 GetFileVersion을 대체합니다.

ICLRMetaHost::QueryLegacyV2RuntimeBinding 메서드

레거시 활성화 정책이 바인딩된 런타임을 나타내는 인터페이스를 반환합니다. 예를 들어, <startup> 요소 구성 파일 항목에서 useLegacyV2RuntimeActivationPolicy를 사용하거나, 레거시 활성화 API를 사용하거나, ICLRRuntimeInfo::BindAsLegacyV2Runtime 메서드를 호출합니다.

ICLRMetaHost::RequestRuntimeLoadedNotification 메서드

CLR 버전이 처음 로드되었지만 아직 시작되지 않았을 때 지정된 함수 포인터에 대한 콜백을 보증합니다. 이 메서드는 LockClrVersion을 대체합니다.

설명

이 인터페이스의 인스턴스를 가져오는 유일한 방법은 다음과 같이 CLRCreateInstance 함수를 호출하는 것입니다.

ICLRMetaHost *pMetaHost = NULL;
HRESULT hr = CLRCreateInstance(CLSID_CLRMetaHost,
                   IID_ICLRMetaHost, (LPVOID*)&pMetaHost);

요구 사항

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

헤더: MetaHost.h

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

.NET Framework 버전: 4

참고 항목

기타 리소스

호스팅 인터페이스

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

변경 기록

날짜

변경 내용

이유

2010년 9월

코드 목록에서 IID를 수정했습니다.

고객 의견