Partager via


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