ICLRRuntimeHost

업데이트: 2007년 11월

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

호스트 제어 인터페이스를 설정하기 위한 SetHostControl 메서드 추가
ICorRuntimeHost에서 제공하는 일부 메서드 생략

interface ICLRRuntimeHost : IUnknown {
        
    HRESULT ExecuteApplication (
        [in] LPCWSTR                   pwzAppFullName,
        [in] DWORD                     dwManifestPaths,
        [in] LPCWSTR                   *ppwzManifestPaths,   
        [in] DWORD                     dwActivationData,
        [in] LPCWSTR                   *ppwzActivationData,  
        [out] int                      *pReturnValue
    );
        
    HRESULT ExecuteInAppDomain (
        [in] DWORD                     appDomainId, 
        [in] FExecuteInDomainCallback  pCallback,
        [in] void*                     cookie
    );
        
    HRESULT ExecuteInDefaultAppDomain (
        [in] LPCWSTR                   pwzAssemblyPath, 
        [in] LPCWSTR                   pwzTypeName,
        [in] LPCWSTR                   pwzMethodName,
        [in] LPCWSTR                   pwzArgument,
        [out] DWORD                    *pReturnValue
    );
        
    HRESULT GetCLRControl (
        [out] ICLRControl              **pCLRControl
    );
        
    HRESULT GetCurrentAppDomainId (
        [out] DWORD                    *pdwAppDomainId
    );
        
    HRESULT SetHostControl (
        [in] IHostControl              *pHostControl
    );
        
    HRESULT Start();
        
    HRESULT Stop();
        
    HRESULT UnloadAppDomain (
        [in] DWORD                     dwAppDomainId
        [in] BOOL                      fWaitUntilDone
    );
        
};

메서드

메서드	설명
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을 언로드합니다.

설명

호스트는 CorBindToRuntimeEx 또는 CorBindToCurrentRuntime을 호출하여 ICLRRuntimeHost 인스턴스에 대한 포인터를 가져옵니다. .NET Framework 버전 2.0에서 제공하는 모든 기술 구현을 제공하려면 ICorRuntimeHost 대신 ICLRRuntimeHost를 사용해야 합니다.

중요

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