ICorRuntimeHost::CreateDomainEx Method
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: 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
Concepts
ICorRuntimeHost::CreateDomain Method