ICLRRuntimeHost 인터페이스

업데이트: 2010년 6월

다음과 같은 변경 내용을 포함하여 .NET Framework 버전 1에 제공된 ICorRuntimeHost 인터페이스와 유사한 기능을 제공합니다.

• 호스트 제어 인터페이스를 설정하기 위한 SetHostControl 메서드 추가

• ICorRuntimeHost에서 제공하는 일부 메서드 생략

메서드

메서드	설명
ICLRRuntimeHost::ExecuteApplication 메서드	새 도메인에서 활성화될 응용 프로그램을 지정하기 위해 매니페스트 기반의 ClickOnce 배포 시나리오에서 사용됩니다.
ICLRRuntimeHost::ExecuteInAppDomain 메서드	지정된 관리 코드를 실행할 AppDomain을 지정합니다.
ICLRRuntimeHost::ExecuteInDefaultAppDomain 메서드	지정한 어셈블리에서 지정한 형식의 지정한 메서드를 호출합니다.
ICLRRuntimeHost::GetCLRControl 메서드	호스트에서 CLR(공용 언어 런타임)의 여러 특성을 사용자 지정하는 데 사용할 수 있는 ICLRControl 형식의 인터페이스 포인터를 가져옵니다.
ICLRRuntimeHost::GetCurrentAppDomainId 메서드	현재 실행 중인 AppDomain의 숫자 식별자를 가져옵니다.
ICLRRuntimeHost::SetHostControl 메서드	호스트 제어 인터페이스를 설정합니다. Start를 호출하기 전에 SetHostControl을 호출해야 합니다.
ICLRRuntimeHost::Start 메서드	CLR을 프로세스로 초기화합니다.
ICLRRuntimeHost::Stop 메서드	런타임에서 코드 실행을 중지합니다.
ICLRRuntimeHost::UnloadAppDomain 메서드	지정한 숫자 식별자에 해당하는 AppDomain을 언로드합니다.

설명

.NET Framework 버전 4으로 시작하는 경우 ICLRMetaHost 인터페이스를 사용하여 ICLRRuntimeInfo 인터페이스에 포인터를 가져온 후 ICLRRuntimeInfo::GetInterface 메서드를 호출하여 포인터를 ICLRRuntimeHost로 가져옵니다. .NET Framework의 이전 버전에서 호스트는 CorBindToRuntimeEx 또는 CorBindToCurrentRuntime을 호출하여 ICLRRuntimeHost 인스턴스에 대한 포인터를 가져옵니다. .NET Framework 버전 2.0에서 제공하는 모든 기술 구현을 제공하려면 ICorRuntimeHost 대신 ICLRRuntimeHost를 사용해야 합니다.

중요
Start 메서드를 호출하려면 먼저 ExecuteApplication 메서드를 호출하여 매니페스트 기반 응용 프로그램을 활성화해야 합니다.Start 메서드를 먼저 호출하면 ExecuteApplication 메서드를 호출할 때 오류가 발생합니다.

요구 사항

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

헤더: MSCorEE.h

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

.NET Framework 버전: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

참고 항목

참조

CorBindToCurrentRuntime 함수

CorBindToRuntimeEx 함수

ICLRControl 인터페이스

ICorRuntimeHost 인터페이스

CLRRuntimeHost Coclass

개념

호스팅 개요

기타 리소스

호스팅 인터페이스

변경 기록

날짜	변경 내용	이유
2010년 6월	인터페이스에 대한 포인터를 얻기를 위한 명령을 수정했습니다.	콘텐츠 버그 수정