Share via

ICorRuntimeHost::CreateDomainEx Method

  • Article

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
);

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

Header: MSCorEE.h

Library: Included as a resource in MSCorEE.dll

.NET Framework Version: 1.0, 1.1

See Also

Reference

_AppDomain

AppDomain

ICorRuntimeHost::CreateDomain Method

IAppDomainSetup Interface

ICorRuntimeHost Interface

System.IAppDomainSetup