ICLRRuntimeHost (Interfaz)

Proporciona una funcionalidad similar a la de la interfaz ICorRuntimeHost proporcionada en la versión 1 de .NET Framework, con los siguientes cambios:

  • La adición del método SetHostControl para establecer la interfaz de control de host.

  • La omisión de algunos métodos proporcionados por ICorRuntimeHost.

Métodos

Método Descripción
Método ExecuteApplication Se usa en escenarios de implementación ClickOnce basados en manifiestos para especificar la aplicación que se va a activar en un nuevo dominio.
Método ExecuteInAppDomain Especifica en qué elemento AppDomain se va a ejecutar el código administrado especificado.
Método ExecuteInDefaultAppDomain Invoca al método especificado del tipo especificado en el ensamblado especificado.
Método GetCLRControl Obtiene un puntero de interfaz de tipo ICLRControl que los hosts pueden usar para personalizar aspectos de Common Language Runtime (CLR).
Método GetCurrentAppDomainId Obtiene el identificador numérico del elemento AppDomain que se está ejecutando actualmente.
Método SetHostControl Establece la interfaz de control de host. Debe llamar a SetHostControl antes de llamar a Start.
Start (método) Inicializa el CLR en un proceso.
Stop (método) Detiene la ejecución del código por el tiempo de ejecución.
Método UnloadAppDomain Descarga el elemento AppDomain que corresponde al identificador numérico especificado.

Comentarios

A partir de .NET Framework 4, use la interfaz ICLRMetaHost para obtener un puntero a la interfaz ICLRRuntimeInfo y, a continuación, llame al método ICLRRuntimeInfo::GetInterface para obtener un puntero en ICLRRuntimeHost. En versiones anteriores de .NET Framework, el host obtiene un puntero a una ICLRRuntimeHost instancia mediante una llamada a CorBindToRuntimeEx o CorBindToCurrentRuntime. Para proporcionar implementaciones de cualquiera de las tecnologías proporcionadas en .NET Framework versión 2.0, debe usar ICLRRuntimeHost en lugar de ICorRuntimeHost.

Importante

No llame al método Start Method antes de llamar al método ExecuteApplication para activar una aplicación basada en manifiestos. Si se llama primero al método Start, se producirá un error en la llamada de método ExecuteApplication.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.h

Biblioteca: incluida como recurso en MSCorEE.dll

Versiones de .NET Framework: disponible a partir de la versión 2.0

Consulte también