Compartir a través de

CorBindToRuntimeEx

Habilita hosts no administrados para cargar Common Language Runtime en un proceso. Vea Alojar Common Language Runtime para obtener una descripción completa de los escenarios en los que se utiliza CorBindToRuntimeEx.

Este método adopta una serie de parámetros que permiten a un host hacer lo siguiente:

  • Especificar la versión del motor en tiempo de ejecución que se cargará.

  • Indicar si se debe cargar la versión para el servidor o la de estaciones de trabajo.

  • Controlar si se realiza recolección simultánea o no simultánea de los elementos no utilizados.

  • Determinar si se cargan los ensamblados como neutrales con respecto al dominio.

  • Obtener un puntero de interfaz a una instancia de ICorRuntimeHost que puede utilizarse para establecer diversas opciones adicionales que permitan a un host configurar una instancia de Common Language Runtime antes de iniciarla.

HRESULT CorBindToRuntimeEx ( 
    LPWSTR pwszVersion,   
    LPWSTR pwszBuildFlavor, 
    DWORD flags,            
    REFCLSID rclsid,      
    REFIID riid,    
    LPVOID* ppv
);

Parámetros

Parámetro Descripción

pwszVersion

[in] Cadena que describe la versión de Common Language Runtime que se desea cargar.

En .NET Framework, un número de versión se compone de cuatro partes separadas por puntos: principal.secundaria.compilación.revisión. La cadena pasada como pwszVersion debe comenzar por el carácter "v" seguido por las tres primeras partes del número de versión. Por ejemplo,

   v1.0.1529

Algunas versiones de Common Language Runtime se instalan con una instrucción de directiva que especifica la compatibilidad con versiones anteriores. De forma predeterminada, el proceso intermedio ("shim") de inicio evalúa pwszVersion con las instrucciones de directiva y carga la versión más reciente del motor en tiempo de ejecución compatible con la versión solicitada. Un host puede hacer que el proceso intermedio ("shim") omita la evaluación de directivas y cargue exactamente la versión especificada en pwszVersion pasando un valor de STARTUP_LOADER_SAFEMODE para flags. Vea la descripción de flags más adelante.

Si el llamador especifica null como valor de pwszVersion, se cargará la versión más reciente de Common Language Runtime. Pasar este valor hace que el host no tenga ningún control sobre la versión del motor en tiempo de ejecución que se carga. Aunque esto puede ser apropiado en algunos escenarios, se recomienda encarecidamente que el host proponga cargar una versión específica.

pwszBuildFlavor

[in] Cadena que especifica si se debe cargar la versión de Common Language Runtime para el servidor o para la estación de trabajo. Los valores válidos son "wks" y "svr". La versión para el servidor está optimizada para aprovechar las ventajas que aportan varios procesadores al realizar recolecciones de elementos no utilizados, mientras que la versión para las estaciones de trabajo está pensada para aplicaciones cliente que se ejecutan en equipos con un solo procesador.

Si se establece pwszBuildFlavor en null, se cargará la versión para estaciones de trabajo. Cuando la ejecución se lleva a cabo en un equipo con un solo procesador, se carga siempre la versión para estaciones de trabajo, incluso aunque pwszBuildFlavor esté establecido en "svr". Sin embargo, si se pasa "svr" y se especifica la recolección simultánea de elementos no utilizados (vea la descripción del parámetro flags más adelante), se cargará la versión para el servidor. Normalmente, no es aconsejable ejecutar una recolección simultánea de elementos no utilizados en una versión para servidor, pero el proceso intermedio ("shim") de inicio de Common Language Runtime no incluye lógica especial para evitar esta configuración.

flags

[in] Conjunto de indicadores que controla la recolección simultánea de elementos no utilizados, el código neutral respecto al dominio y el comportamiento del parámetro pwszVersion. Si ninguno de los indicadores está establecido, el valor predeterminado es un solo dominio. Valores válidos son:

  • STARTUP_CONCURRENT_GC Especifica que se debe utilizar la recolección simultánea de elementos no utilizados. Si el llamador solicita la versión del servidor y la recolección simultánea de elementos no utilizados en un equipo con un solo procesador, se ejecutará en su lugar la versión de la estación de trabajo y la recolección no simultánea de elementos no utilizados.

  • STARTUP_LOADER_OPTIMIZATION_SINGLE_DOMAIN No se carga ningún ensamblado como neutral con respecto al dominio.

  • STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN Todos los ensamblados se cargan como neutrales con respecto al dominio.

  • STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN_HOST Todos los ensamblados con nombre seguro se cargan como neutrales con respecto al dominio.

  • STARTUP_LOADER_SAFEMODE Especifica que se cargará la versión exacta de Common Language Runtime pasada en pwszVersion. El proceso intermedio ("shim") no evalúa directivas para determinar la última versión compatible.

  • STARTUP_LEGACY_IMPERSONATION

rclsid

[in] CLSID de la coclase que implementa la interfaz ICorRuntimeHost. Los valores admitidos son CLSID_CorRuntimeHost o CLSID_CLRRuntimeHost.

riid

[in] IID de la interfaz solicitada de rclsid. Los valores admitidos son IID_ICorRuntimeHost o IID_ICLRRuntimeHost.

ppv

[out] Puntero de interfaz devuelto a riid.

Comentarios

Si pwszVersion especifica una versión del motor en tiempo de ejecución que no existe, CorBindToRuntimeEx devolverá un valor de HRESULT de CLR_E_SHIM_RUNTIMELOAD.

Requisitos

Plataformas: Windows 2000, Windows XP, familia de Windows Server 2003

Encabezado: Se declara en Mscoree.h

Biblioteca: Se incluye como recurso en Mscoree.dll

Vea también

Referencia

CorBindToRuntime

  • Last updated on