Partilhar via


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

Ver também