Поделиться через


Интерфейс ICorRuntimeHost

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

Предоставляет методы, позволяющие основному приложению явным образом запускать и останавливать выполнение среды CLR для создания и настройки доменов приложения с целью доступа к домену по умолчанию и перечисления всех доменов, выполняемых в процессе.

В платформе .NET Framework версии 2.0 этот интерфейс замещен интерфейсом ICLRRuntimeHost.

interface ICorRuntimeHost : IUnknown { 
    HRESULT CloseEnum (
        [in] HCORENUM hEnum
    );
    HRESULT CreateDomain (
        [in] LPWSTR pwzFriendlyName,
        [in] IUnknown* pIdentityArray, 
        [out] void ** pAppDomain
    );
    HRESULT CreateDomainEx (
        [in] LPCWSTR pwzFriendlyName, 
        [in] IUnknown* pSetup, 
        [in] IUnknown* pEvidence, 
        [out] IUnknown** pAppDomain
    );
    HRESULT CreateDomainSetup (
        [out] IUnknown** pAppDomainSetup
    );
    HRESULT CreateEvidence (
        [out] IUnknown** pEvidence
    );
    HRESULT CreateLogicalThreadState();
    HRESULT CurrentDomain (
        [out] IUnknown** pAppDomain
    );
    HRESULT DeleteLogicalThreadState();
    HRESULT EnumDomains (
        [out] HCORENUM *hEnum
    );
        HRESULT GetConfiguration(
            [out] ICorConfiguration** pConfiguration
        );
    HRESULT GetDefaultDomain (
        [out] IUnknown** pAppDomain
    );
    HRESULT LocksHeldByLogicalThread(
             [out] DWORD *pCount 
        );
    HRESULT NextDomain (
        [in] HCORENUM hEnum,
        [out] void** pAppDomain
    );
    HRESULT Start ();
    HRESULT Stop ();
    HRESULT SwitchInLogicalThreadState(
             [in] DWORD *pFiberCookie);
    HRESULT SwitchOutLogicalThreadState(
             [out] DWORD **pFiberCookie);
    HRESULT UnloadDomain (
        [in] IUnknown* pAppDomain
    ); 
}

Методы

Метод

Описание

Метод ICorRuntimeHost::CloseEnum

Сбрасывает перечислитель доменов в начало их списка.

Метод ICorRuntimeHost::CreateDomain

Создает домен приложения. Вызывающий объект получает указатель интерфейса типа _AppDomain на экземпляр типа System.AppDomain.

Метод ICorRuntimeHost::CreateDomainEx

Создает домен приложения. Этот метод позволяет вызывающему объекту передать экземпляр интерфейса IAppDomainSetup для настройки дополнительных функций возвращенного экземпляра _AppDomain.

Метод ICorRuntimeHost::CreateDomainSetup

Получает указатель интерфейса типа IAppDomainSetup на интерфейс AppDomainSetup. Интерфейс IAppDomainSetup предоставляет методы настройки особенностей домена приложения до его создания.

Метод ICorRuntimeHost::CreateEvidence

Получает указатель интерфейса типа IIdentity, позволяющий основному приложению создавать свидетельства безопасности, передаваемые в CreateDomain или CreateDomainEx.

Метод ICorRuntimeHost::CreateLogicalThreadState

Не используется.

Метод ICorRuntimeHost::CurrentDomain

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

Метод ICorRuntimeHost::DeleteLogicalThreadState

Не используется.

Метод ICorRuntimeHost::EnumDomains

Получает перечислитель для доменов в текущем процессе.

Метод ICorRuntimeHost::GetConfiguration

Получает объект, позволяющий основному приложению задавать настройку обратного вызова среды CLR.

Метод ICorRuntimeHost::GetDefaultDomain

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

Метод ICorRuntimeHost::LocksHeldByLogicalThread

Не используется.

Метод ICorRuntimeHost::MapFile

Отображает заданный файл в памяти. Этот метод устарел.

Метод ICorRuntimeHost::NextDomain

Получает указатель интерфейса на следующий домен в перечислении.

Метод ICorRuntimeHost::Start

Запускает среду CLR.

Метод ICorRuntimeHost::Stop

Останавливает выполнение кода в среде выполнения для текущего процесса.

Метод ICorRuntimeHost::SwitchInLogicalThreadState

Не используется.

Метод ICorRuntimeHost::SwitchOutLogicalThreadState

Не используется.

Метод ICorRuntimeHost::UnloadDomain

Выгружает указанный домен приложения из текущего процесса.

Требования

Платформы: см. раздел Требования к системе для .NET Framework.

Заголовок: MSCorEE.idl

Библиотека: включена как ресурс в MSCorEE.dll

Версии .NET Framework: 1.0, 1.1

См. также

Основные понятия

Узлы среды выполнения

Ссылки

AppDomain

Интерфейс IAppDomainSetup

Интерфейс ICLRRuntimeHost

Другие ресурсы

Размещение среды CLR

Интерфейсы размещения