Método ICorRuntimeHost::CreateDomainEx

Artigo
05/10/2023

Criar um domínio do 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 passe uma instância IAppDomainSetup para configurar recursos adicionais da instância retornada _AppDomain.

Sintaxe

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 ao domínio. Este nome amigável pode ser exibido nas interfaces do usuário a fim de 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 instâncias IIdentity que representam evidências mapeadas por meio da política de segurança para estabelecer um conjunto de permissões. Um objeto IIdentity pode ser obtido chamando o método CreateEvidence.

pAppDomain
[out] Um ponteiro de interface do tipo _AppDomain para uma instância de System.AppDomain que pode ser usada para controlar ainda mais o domínio.

Valor Retornado

HRESULT	Descrição
S_OK	A operação foi bem-sucedida.
S_FALSE	Falha ao concluir a operação.
E_FAIL	Uma falha catastrófica desconhecida ocorreu. Se um método retornar E_FAIL, o CLR (Common Language Runtime) não poderá mais ser usado no processo. Chamadas subsequentes para APIs de hospedagem retornam HOST_E_CLRNOTAVAILABLE.
HOST_E_CLRNOTAVAILABLE	O CLR não foi carregado em um processo, ou o CLR está em um estado no qual não pode executar código gerenciado ou processar a chamada com êxito.

Comentários

CreateDomainEx estende os recursos de CreateDomain permitindo que o chamador passe uma instância IAppDomainSetup com valores de propriedade para configurar o domínio do aplicativo.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: MSCorEE.h

Biblioteca: incluída como um recurso no MSCorEE.dll

Versão do .NET Framework: 1.0, 1.1

Compartilhar via