ICorRuntimeHost::CreateDomainEx Method


Creates an application domain. The caller receives an interface pointer, of type _AppDomain, to an instance of type System.AppDomain. This method allows the caller to pass an IAppDomainSetup instance to configure additional features of the returned _AppDomain instance.

HRESULT CreateDomainEx (  
    [in] LPCWSTR     pwzFriendlyName,  
    [in] IUnknown*   pSetup,  
    [in] IUnknown*   pIdentityArray,  
    [out] IUnknown** pAppDomain  


[in] An optional parameter used to give a friendly name to the domain. This friendly name can be displayed in user interfaces such as debuggers to identify the domain.

[in] An optional interface pointer of type IAppDomainSetup, obtained by a call to the ICorRuntimeHost::CreateDomainSetup method.

[in] An optional array of pointers to IIdentity instances that represent evidence mapped through security policy to establish a permission set. An IIdentity object can be obtained by calling the CreateEvidence method.

[out] An interface pointer of type _AppDomain to an instance of System.AppDomain that can be used to further control the domain.

S_OKThe operation was successful.
S_FALSEThe operation failed to complete.
E_FAILAn unknown, catastrophic failure occurred. If a method returns E_FAIL, the common language runtime (CLR) is no longer usable in the process. Subsequent calls to any hosting APIs return HOST_E_CLRNOTAVAILABLE.
HOST_E_CLRNOTAVAILABLEThe CLR has not been loaded into a process, or the CLR is in a state in which it cannot run managed code or process the call successfully.

CreateDomainEx extends the capabilities of CreateDomain by allowing the caller to pass in an IAppDomainSetup instance with property values for configuring the application domain.

Platforms: See System Requirements.

Header: MSCorEE.h

Library: Included as a resource in MSCorEE.dll

.NET Framework Version: 1.0, 1.1

CreateDomain Method
ICorRuntimeHost Interface