Método ICorRuntimeHost::CreateDomainEx
Cria um domínio de aplicação. O autor da chamada recebe um ponteiro de interface, do tipo _AppDomain, para uma instância do tipo System.AppDomain. Este método permite que o autor da chamada transmita uma instância IAppDomainSetup para configurar funcionalidades adicionais da instância devolvida _AppDomain .
Sintaxe
HRESULT CreateDomainEx (
[in] LPCWSTR pwzFriendlyName,
[in] IUnknown* pSetup,
[in] IUnknown* pIdentityArray,
[out] IUnknown** pAppDomain
);
Parâmetros
pwzFriendlyName
[in] Um parâmetro opcional utilizado para dar um nome amigável ao domínio. Este nome amigável pode ser apresentado em interfaces de utilizador, como depuradores para identificar o domínio.
pSetup
[in] Um ponteiro de interface opcional do tipo IAppDomainSetup
, obtido por uma chamada para o método ICorRuntimeHost::CreateDomainSetup .
pIdentityArray
[in] Uma matriz opcional de ponteiros para IIdentity
instâncias que representam provas mapeadas através da política de segurança para estabelecer um conjunto de permissões. Um IIdentity
objeto pode ser obtido ao chamar o método CreateEvidence .
pAppDomain
[fora] Um ponteiro de interface do tipo _AppDomain para uma instância do System.AppDomain que pode ser utilizado para controlar ainda mais o domínio.
Devolver Valor
HRESULT | Description |
---|---|
S_OK | A operação foi efetuada com êxito. |
S_FALSE | Falha ao concluir a operação. |
E_FAIL | Ocorreu uma falha catastrófica desconhecida. Se um método devolver E_FAIL, o runtime de linguagem comum (CLR) já não é utilizável no processo. As chamadas subsequentes para quaisquer APIs de alojamento devolvem HOST_E_CLRNOTAVAILABLE. |
HOST_E_CLRNOTAVAILABLE | O CLR não foi carregado para um processo ou o CLR está num estado em que não pode executar o código gerido ou processar a chamada com êxito. |
Observações
CreateDomainEx
expande as capacidades de CreateDomain ao permitir que o autor da chamada transmita uma IAppDomainSetup
instância com valores de propriedade para configurar o domínio da aplicação.
Requisitos
Plataformas: Veja Requisitos de Sistema.
Cabeçalho: MSCorEE.h
Biblioteca: Incluído como um recurso no MSCorEE.dll
.NET Framework Versão: 1.0, 1.1