Método ICLRDomainManager::SetAppDomainManagerType

Artigo
05/10/2023

Especifica o tipo, derivado da classe System.AppDomainManager, do gerenciador de domínio do aplicativo que será usado para inicializar o domínio de aplicativo padrão.

Sintaxe

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

Parâmetros

wszAppDomainManagerAssembly
[in] O nome de exibição do assembly que contém o tipo do gerenciador de domínio do aplicativo; por exemplo: "AdMgrExample, Version=1.0.0.0, Culture=neutral, PublicKeyToken=6856bccf150f00b3".

wszAppDomainManagerType
[in] O nome do tipo do gerenciador de domínio do aplicativo, incluindo o namespace.

dwInitializeDomainFlags
[in] Uma combinação de valores de enumeração EInitializeNewDomainFlags que fornecem informações sobre o gerenciador de domínio do aplicativo.

Valor Retornado

Esse método retorna os seguintes HRESULTs específicos, bem como erros HRESULT que indicam falha de método.

HRESULT	Descrição
S_OK	O método foi concluído com sucesso.
HOST_E_CLRNOTAVAILABLE	O CLR (Common Language Runtime) não foi carregado em um processo ou está em um estado no qual não pode executar o código gerenciado ou processar a chamada com êxito.

Comentários

Atualmente, o único valor definido para dwInitializeDomainFlags é eInitializeNewDomainFlags_NoSecurityChanges, que informa ao CLR (Common Language Runtime) que o gerenciador de domínio do aplicativo não modificará as configurações de segurança durante a execução do método AppDomainManager.InitializeNewDomain. Isso permite que o CLR otimize o carregamento de assemblies que têm o atributo condicional AllowPartiallyTrustedCallersAttribute (APTCA). Isso pode resultar em uma melhoria significativa no tempo de inicialização se o fechamento transitivo desse conjunto de assemblies for grande.

Importante

Se o host especificar eInitializeNewDomainFlags_NoSecurityChanges para o gerenciador de domínio do aplicativo, um InvalidOperationException será lançado se qualquer tentativa for feita de modificar a segurança do domínio do aplicativo.

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

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: MetaHost.h

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

Versões do .NET Framework: disponíveis desde 4

Compartilhar via