Compartir a través de

ICorRuntimeHost::CreateDomainEx (Método)

  • Artículo

Crea un dominio de aplicación. El autor de la llamada recibe un puntero de interfaz de tipo _AppDomain a una instancia de tipo System.AppDomain. Este método permite al autor de la llamada pasar una instancia de IAppDomainSetup para configurar características adicionales de la instancia _AppDomain devuelta.

Sintaxis

HRESULT CreateDomainEx (  
    [in] LPCWSTR     pwzFriendlyName,  
    [in] IUnknown*   pSetup,  
    [in] IUnknown*   pIdentityArray,  
    [out] IUnknown** pAppDomain  
);

Parámetros

pwzFriendlyName
[in] Parámetro opcional que se usa para asignar un nombre descriptivo al dominio. Este nombre descriptivo puede mostrarse en las interfaces de usuario, tales como depuradores, para identificar el dominio.

pSetup
[in] Puntero de interfaz opcional de tipo IAppDomainSetup, obtenido por una llamada al método ICorRuntimeHost::CreateDomainSetup.

pIdentityArray
[in] Matriz opcional de punteros a instancias de IIdentity que representan la evidencia asignada mediante la directiva de seguridad para establecer un conjunto de permisos. Se puede obtener un objeto IIdentity llamando al método CreateEvidence.

pAppDomain
[out] Puntero de interfaz de tipo _AppDomain a una instancia de System.AppDomain que se puede usar para controlar aún más el dominio.

Valor devuelto

HRESULT Descripción
S_OK La operación se realizó correctamente.
S_FALSE No se ha podido completar la operación.
E_FAIL Se ha producido un error grave desconocido. Si un método devuelve E_FAIL, Common Language Runtime (CLR) ya no se puede usar en el proceso. Las llamadas posteriores a cualquier API de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.
HOST_E_CLRNOTAVAILABLE Si se devuelve este valor, significa que Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar código administrado ni procesar la llamada correctamente.

Comentarios

CreateDomainEx amplía las funcionalidades de CreateDomain al permitir que el autor de la llamada pase una instancia IAppDomainSetup con valores de propiedad para configurar el dominio de aplicación.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.h

Biblioteca: incluida como recurso en MSCorEE.dll

Versión de .NET Framework: 1.0, 1.1

Consulte también