ICorRuntimeHost::CreateDomainEx 方法

创建应用程序域。 调用方接收指向 _AppDomain 类型实例的 System.AppDomain 类型的接口指针。 此方法允许调用方传递一个 IAppDomainSetup 实例,以配置返回的 _AppDomain 实例的其他功能。

HRESULT CreateDomainEx (
    [in] LPCWSTR     pwzFriendlyName,
    [in] IUnknown*   pSetup,
    [in] IUnknown*   pIdentityArray,
    [out] IUnknown** pAppDomain
);

参数

  • pwzFriendlyName
    [in] 用于向域提供友好名称的可选参数。 此友好名称可显示在用户界面中,如显示在调试器中以标识域。

  • pSetup
    [in] 类型为 IAppDomainSetup 的可选接口指针,通过调用 ICorRuntimeHost::CreateDomainSetup 方法获得。

  • pIdentityArray
    [in] 一个可选指针数组,这些指针指向表示通过安全策略映射的证据的 IIdentity 实例,用于建立权限集。 一个 IIdentity 对象,该对象可通过调用 CreateEvidence 方法获得。

  • pAppDomain
    [out] 指向 _AppDomain 实例的 System.AppDomain 类型的接口指针,用于对域进一步进行控制。

返回值

HRESULT

说明

S_OK

操作成功。

S_FALSE

操作未能完成。

E_FAIL

发生未知的灾难性故障。 如果某方法返回 E_FAIL,公共语言运行时 (CLR) 便无法再在进程中使用。 对任何宿主 API 的后续调用都将返回 HOST_E_CLRNOTAVAILABLE。

HOST_E_CLRNOTAVAILABLE

CLR 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。

备注

CreateDomainEx 通过允许调用方传入具有属性值的 IAppDomainSetup 实例(用于配置应用程序域)来扩展 CreateDomain 的功能。

要求

**平台:**请参见 .NET Framework 系统要求

**头文件:**MSCorEE.h

**库:**作为一项资源包含在 MSCorEE.dll 中

**.NET Framework 版本:**1.0、1.1

请参见

参考

_AppDomain

AppDomain

ICorRuntimeHost::CreateDomain 方法

IAppDomainSetup 接口

ICorRuntimeHost 接口

System.IAppDomainSetup