Интерфейс ICLRRuntimeHost

Статья
11/16/2008

Обновлен: Ноябрь 2007

Предоставляет функциональные возможности, аналогичные функциональным возможностям интерфейса ICorRuntimeHost, которые предоставляются в платформе .NET Framework версии 1, со следующими изменениями.

Добавлен метод 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	Получает указатель интерфейса типа ICLRControl, с помощью которого основные приложения могут настраивать аспекты среды CLR.
Метод ICLRRuntimeHost::GetCurrentAppDomainId	Получает числовой идентификатор выполняемого в данный момент объекта AppDomain.
Метод ICLRRuntimeHost::SetHostControl	Задает интерфейс управления основным приложением. Перед вызовом метода Start следует вызвать метод SetHostControl.
Метод ICLRRuntimeHost::Start	Инициализируется среду CLR в процессе.
Метод ICLRRuntimeHost::Stop	Останавливает выполнение кода средой выполнения.
Метод ICLRRuntimeHost::UnloadAppDomain	Загружает объект AppDomain, соответствующий указанному числовому идентификатору.

Заметки

Основное приложение получает указатель на экземпляр ICLRRuntimeHost, вызвав функцию CorBindToRuntimeEx илиCorBindToCurrentRuntime. Для предоставления реализаций технологий, предусмотренных в платформе .NET Framework версии 2.0 следует воспользоваться экземпляром ICLRRuntimeHost интерфейса ICorRuntimeHost.

Важное примечание.
Метод Start не следует вызывать до вызова метода ExecuteApplication для активации приложения на основе манифеста. Если сначала вызывается метод Start, при вызове метода ExecuteApplication происходит сбой.