Método de ICLRDomainManager::SetAppDomainManagerType

Artigo
08/08/2011

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

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 de Gerenciador de domínio de aplicativo; Por exemplo: "AdMgrExample, versão = 1.0.0.0, Culture = neutral, PublicKeyToken = 6856bccf150f00b3".
wszAppDomainManagerType
[in] O nome do gerente de domínio de aplicativo, incluindo o namespace do tipo.
dwInitializeDomainFlags
[in] Uma combinação de EInitializeNewDomainFlags valores de enumeração que fornecem informações sobre o Gerenciador de domínio de aplicativo.

Valor de retorno

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

HRESULT	Descrição
S_OK	O método foi concluído com êxito.
HOST_E_CLRNOTAVAILABLE	O common language runtime (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

Atualmente, o único valor definido para dwInitializeDomainFlags é eInitializeNewDomainFlags_NoSecurityChanges, que informa o common language runtime (CLR) que o Gerenciador de domínios de aplicativo não modificará as configurações de segurança durante a execução da AppDomainManager.InitializeNewDomain método. Isso permite que o CLR otimizar o carregamento de módulos (assemblies) que possuem o condicional AllowPartiallyTrustedCallersAttribute (APTCA) atributo. Isso pode resultar em uma melhoria significativa no tempo de inicialização, se o fechamento transitivo deste conjunto de módulos (assemblies) for grande.

Importante
Se o host Especifica eInitializeNewDomainFlags_NoSecurityChanges para o Gerenciador de domínio de aplicativo, um InvalidOperationException é lançada se qualquer tentativa de modificar a segurança do domínio de aplicativo.

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