Метод ICorRuntimeHost::CreateDomainEx

Статья
08/11/2011

Создает домен приложения. Вызывающий объект получает указатель интерфейса типа _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 расширяет возможности CreateDomain, позволяя вызывающему объекту передавать экземпляр IAppDomainSetup со значениями свойства для настройки домена приложения.