ICorRuntimeHost::CreateDomain Method

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

HRESULT CreateDomain (
    [in] LPWSTR    pwzFriendlyName,
    [in] IUnknown* pIdentityArray,
    [out] void   **pAppDomain


  • 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




The operation was successful.


The operation failed to complete.


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.


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.


Platforms: See .NET Framework System Requirements.

Header: MSCorEE.h

Library: Included as a resource in MSCorEE.dll

.NET Framework Versions: 1.0, 1.1

See Also




ICorRuntimeHost Interface