ICorRuntimeHost::CreateDomain Method

Creates an application domain. The caller receives an interface pointer of type _AppDomain to an instance of type System.AppDomain.

Syntax

HRESULT CreateDomain (  
    [in] LPWSTR    pwzFriendlyName,  
    [in] IUnknown* pIdentityArray,  
    [out] void   **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 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.

Requirements

Platforms: See System Requirements.

Header: MSCorEE.h

Library: Included as a resource in MSCorEE.dll

.NET Framework Versions: 1.0, 1.1

See also