ICLRDomainManager::SetAppDomainManagerType (Método)

Artículo
08/10/2011

Especifica el tipo, derivado de la clase System.AppDomainManager, del administrador del dominio de aplicación que se utilizará para inicializar el dominio de aplicación predeterminado.

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

Parámetros

wszAppDomainManagerAssembly
[in] El nombre para mostrar del ensamblado que contiene el tipo de administrador de dominios de aplicación; por ejemplo: "AdMgrExample, Version=1.0.0.0, Culture=neutral, PublicKeyToken=6856bccf150f00b3".
wszAppDomainManagerType
[in] El nombre de tipo del administrador de dominios de aplicación, incluido el espacio de nombres.
dwInitializeDomainFlags
[in] Una combinación de valores de enumeración EInitializeNewDomainFlags que proporcionan información sobre el administrador del dominio de aplicación.

Valor devuelto

Este método devuelve los siguientes HRESULT específicos, así como errores HRESULT que indican la existencia de un error en el método.

HRESULT	Descripción
S_OK	El método se ha ejecutado correctamente.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (CLR) no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el código administrado o procesar la llamada correctamente.

Comentarios

Actualmente, el único valor definido para dwInitializeDomainFlags es eInitializeNewDomainFlags_NoSecurityChanges, que indica a Common Language Runtime (CLR) que el administrador del dominio de aplicación no modificará la configuración de seguridad durante la ejecución del método AppDomainManager.InitializeNewDomain. Esto permite a CLR optimizar la carga de ensamblados que tienen el atributo AllowPartiallyTrustedCallersAttribute (APTCA) condicional. Esto puede producir una mejora significativa del tiempo de inicio si el cierre transitivo de este conjunto de ensamblados es grande.

Importante
Si el host especifica eInitializeNewDomainFlags_NoSecurityChanges para el administrador del dominio de aplicación, se produce una InvalidOperationException si se realiza cualquier intento de modificar la seguridad del dominio de aplicación.

Llamar al método ICLRControl::SetAppDomainManagerType es equivalente a llamar a ICLRDomainManager::SetAppDomainManagerType con eInitializeNewDomainFlags_None.