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 Interface 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.
  • 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 ICorRuntimeHost::CreateEvidence Method 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 ICorRuntimeHost::CreateDomain Method by allowing the caller to pass in an IAppDomainSetup Interface instance with property values for configuring the application domain.

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

ICorRuntimeHost::CreateDomain Method
IAppDomainSetup Interface
ICorRuntimeHost Interface
_AppDomain
AppDomain
System.IAppDomainSetup