ICorRuntimeHost::CreateDomainEx Method

Article
09/15/2021

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.

Syntax

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

Parameters

pwzFriendlyName
[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.

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

pIdentityArray
[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.

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

Return Value

HRESULT	Description
S_OK	The operation was successful.
S_FALSE	The operation failed to complete.
E_FAIL	An 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_CLRNOTAVAILABLE	The 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.

Remarks

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

Requirements

Platforms: See System Requirements.

Header: MSCorEE.h

Library: Included as a resource in MSCorEE.dll

.NET Framework Version: 1.0, 1.1

Share via