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 |
|---|---|
Resets a domain enumerator back to the beginning of the domain list. |
|
Creates an application domain. The caller receives an interface pointer of type _AppDomain to an instance of type System.AppDomain. |
|
Creates an application domain. This method allows the caller to pass an IAppDomainSetup Interface instance to configure additional features of the returned _AppDomain instance. |
|
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. |
|
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. |
|
Do not use. |
|
Gets an interface pointer of type _AppDomain that represents the domain loaded on the current thread. |
|
Do not use. |
|
Gets an enumerator for the domains in the current process. |
|
Gets an object that allows the host to specify the callback configuration of the CLR. |
|
Gets an interface pointer of type _AppDomain that represents the default domain for the current process. |
|
Do not use. |
|
Maps the specified file into memory. This method is obsolete. |
|
Gets an interface pointer to the next domain in the enumeration. |
|
Starts the CLR. |
|
Stops the execution of code in the runtime for the current process. |
|
Do not use. |
|
Do not use. |
|
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