This topic has not yet been rated - Rate this topic

ICorRuntimeHost::CreateDomainEx Method

.NET Framework 4.5

Creates an application domain. The caller receives an interface pointer, of type _AppDomain, to an instance of type 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
);

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 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 .NET Framework System Requirements.

Header: MSCorEE.h

Library: Included as a resource in MSCorEE.dll

.NET Framework Version: 1.0, 1.1

Reference

_AppDomain

AppDomain

ICorRuntimeHost::CreateDomain Method

IAppDomainSetup Interface

ICorRuntimeHost Interface

IAppDomainSetup

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)