ICorRuntimeHost

项目
08/18/2008

更新：2007 年 11 月

为宿主提供显式启动和停止公共语言运行库 (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 方法	创建应用程序域。调用方接收指向 System.AppDomain 类型实例的 _AppDomain 类型的接口指针。
ICorRuntimeHost::CreateDomainEx 方法	创建应用程序域。此方法允许调用方传递一个 IAppDomainSetup 实例，以配置返回的 _AppDomain 实例的其他功能。
ICorRuntimeHost::CreateDomainSetup 方法	获取一个指向 AppDomainSetup 实例的 IAppDomainSetup 类型的接口指针。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

请参见

通过

ICorRuntimeHost

方法

要求

请参见

概念

参考

其他资源

其他资源