Método ICLRDomainManager::SetAppDomainManagerType

Artigo
05/10/2023

Especifica o tipo, derivado da System.AppDomainManager classe, do gestor de domínio da aplicação que será utilizado para inicializar o domínio de aplicação predefinido.

Sintaxe

HRESULT SetAppDomainManagerType(  
    [in] LPCWSTR wszAppDomainManagerAssembly,  
    [in] LPCWSTR wszAppDomainManagerType,  
    [in] EInitializeNewDomainFlags dwInitializeDomainFlags  
);

Parâmetros

wszAppDomainManagerAssembly
[in] O nome a apresentar da assemblagem que contém o tipo de gestor de domínio da aplicação; por exemplo: "AdMgrExample, Version=1.0.0.0, Culture=neutral, PublicKeyToken=6856bccf150f00b3".

wszAppDomainManagerType
[in] O nome do tipo do gestor de domínio da aplicação, incluindo o espaço de nomes.

dwInitializeDomainFlags
[in] Uma combinação de valores de enumeração EInitializeNewDomainFlags que fornecem informações sobre o gestor de domínio da aplicação.

Devolver Valor

Este método devolve os seguintes HRESULTs específicos, bem como erros HRESULT que indicam a falha do método.

HRESULT	Description
S_OK	O método foi concluído com êxito.
HOST_E_CLRNOTAVAILABLE	O runtime de linguagem comum (CLR) não foi carregado para um processo ou o CLR está num estado em que não pode executar código gerido ou processar a chamada com êxito.

Observações

Atualmente, o único valor definido para dwInitializeDomainFlags é eInitializeNewDomainFlags_NoSecurityChanges, que indica ao runtime de idioma comum (CLR) que o gestor de domínio da aplicação não modificará as definições de segurança durante a execução do AppDomainManager.InitializeNewDomain método. Isto permite ao CLR otimizar o carregamento de assemblagens que têm o atributo condicional AllowPartiallyTrustedCallersAttribute (APTCA). Isto pode resultar numa melhoria significativa no tempo de arranque se o encerramento transitório deste conjunto de assemblagens for grande.

Importante

Se o anfitrião especificar eInitializeNewDomainFlags_NoSecurityChanges para o gestor de domínio da aplicação, é emitido um InvalidOperationException caso seja efetuada uma tentativa de modificar a segurança do domínio da aplicação.

Chamar o método ICLRControl::SetAppDomainManagerTypeé equivalente a chamar ICLRDomainManager::SetAppDomainManagerType com eInitializeNewDomainFlags_None.

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: MetaHost.h

Biblioteca: Incluído como um recurso no MSCorEE.dll

.NET Framework Versões: Disponível desde 4

Partilhar via