ICorRuntimeHost Interface

2009-03-30

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

通过

ICorRuntimeHost Interface

Methods

Requirements

See Also

Concepts

Reference

其他资源