ICorRuntimeHost Interface

Provides methods that enable the host to start and stop the common language runtime (CLR) explicitly, to create and configure application domains, to access the default domain, and to enumerate all domains running in the process.

In the .NET Framework version 2.0, this interface is superceded by ICLRRuntimeHost Interface.

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
    ); 
}

Methods

Method	Description
ICorRuntimeHost::CloseEnum Method	Resets a domain enumerator back to the beginning of the domain list.
ICorRuntimeHost::CreateDomain Method	Creates an application domain. The caller receives an interface pointer of type _AppDomain to an instance of type System.AppDomain.
ICorRuntimeHost::CreateDomainEx Method	Creates an application domain. This method allows the caller to pass an IAppDomainSetup Interface instance to configure additional features of the returned _AppDomain instance.
ICorRuntimeHost::CreateDomainSetup Method	Gets an interface pointer of type IAppDomainSetup to an AppDomainSetup instance. IAppDomainSetup provides methods to configure aspects of an application domain before it is created.
ICorRuntimeHost::CreateEvidence Method	Gets an interface pointer of type Iidentity, which allows the host to create security evidence to pass to ICorRuntimeHost::CreateDomain Method or ICorRuntimeHost::CreateDomainEx Method.
ICorRuntimeHost::CreateLogicalThreadState Method	Do not use.
ICorRuntimeHost::CurrentDomain Method	Gets an interface pointer of type _AppDomain that represents the domain loaded on the current thread.
ICorRuntimeHost::DeleteLogicalThreadState Method	Do not use.
ICorRuntimeHost::EnumDomains Method	Gets an enumerator for the domains in the current process.
ICorRuntimeHost::GetConfiguration Method	Gets an object that allows the host to specify the callback configuration of the CLR.
ICorRuntimeHost::GetDefaultDomain Method	Gets an interface pointer of type _AppDomain that represents the default domain for the current process.
ICorRuntimeHost::LocksHeldByLogicalThread Method	Do not use.
ICorRuntimeHost::MapFile Method	Maps the specified file into memory. This method is obsolete.
ICorRuntimeHost::NextDomain Method	Gets an interface pointer to the next domain in the enumeration.
ICorRuntimeHost::Start Method	Starts the CLR.
ICorRuntimeHost::Stop Method	Stops the execution of code in the runtime for the current process.
ICorRuntimeHost::SwitchInLogicalThreadState Method	Do not use.
ICorRuntimeHost::SwitchOutLogicalThreadState Method	Do not use.
ICorRuntimeHost::UnloadDomain Method	Unloads the specified application domain from the current process.

Requirements

Platforms: Windows 2000, Windows XP, Windows Server 2003 family

Header: MSCorEE.idl

Library: Included as a resource in MSCorEE.dll

.NET Framework Version: 1.0, 1.1

See Also

Reference

IAppDomainSetup Interface
ICLRRuntimeHost Interface
AppDomain

Concepts

Runtime Hosts

Other Resources

Hosting the Common Language Runtime
Hosting Interfaces