Share 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 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 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 CreateDomain or CreateDomainEx.

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

Concepts

Hosting the Common Language Runtime

IAppDomainSetup Interface

ICLRRuntimeHost Interface

Runtime Hosts

Hosting Interfaces

Reference

AppDomain