Método de ICorRuntimeHost::CreateDomainEx

Artigo
08/08/2011

Cria um domínio de aplicativo. O chamador recebe um ponteiro de interface do tipo _AppDomain, para uma instância do tipo System.AppDomain. Esse método permite que o chamador passar um IAppDomainSetup instância para configurar recursos adicionais do retornado _AppDomain instância.

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

Parâmetros

pwzFriendlyName
[in] Um parâmetro opcional usado para dar um nome amigável para o domínio. Esse nome amigável pode ser exibido nas interfaces de usuário, como depuradores para identificar o domínio.
pSetup
[in] Um ponteiro de interface opcional do tipo IAppDomainSetup, obtidos por uma chamada para o ICorRuntimeHost::CreateDomainSetup método.
pIdentityArray
[in] Uma matriz opcional de ponteiros para IIdentity instâncias que representam evidências mapeadas através da diretiva de segurança para estabelecer um conjunto de permissão. Um IIdentity objeto pode ser obtido chamando o CreateEvidence método.
pAppDomain
[out] Um ponteiro de interface do tipo _AppDomain a uma instância de System.AppDomain que pode ser usado para controlar ainda mais o domínio.

Valor de retorno

HRESULT	Descrição
S_OK	A operação foi bem-sucedida.
S_FALSE	Falha ao concluir a operação.
E_FAIL	Ocorreu uma falha desconhecida, catastrófica. Se um método retornar E_FAIL, o common language runtime (CLR) não é usável no processo. Chamadas subseqüentes à hospedagem de APIs retornam HOST_E_CLRNOTAVAILABLE.
HOST_E_CLRNOTAVAILABLE	O CLR não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito.

Comentários

CreateDomainExestende os recursos do CreateDomain , permitindo que o chamador passar um IAppDomainSetup instância com valores de propriedade para configurar o domínio de aplicativo.