CorBindToRuntimeHost (Función)

Artículo
10/07/2008

Actualización: noviembre 2007

Permite a los hosts cargar una versión determinada de Common Language Runtime (CLR) en un proceso.

HRESULT CorBindToRuntimeHost (
    [in] LPCWSTR       pwszVersion, 
    [in] LPCWSTR       pwszBuildFlavor, 
    [in] LPCWSTR       pwszHostConfigFile, 
    [in] VOID*         pReserved, 
    [in] DWORD         startupFlags, 
    [in] REFCLSID      rclsid, 
    [in] REFIID        riid, 
    [out] LPVOID FAR  *ppv
);

Parámetros

pwszVersion
[in] Cadena que describe la versión de CLR que se desea cargar.

En .NET Framework, un número de versión está compuesto de cuatro partes separadas por puntos: principal.secundaria.compilación.revisión. La cadena que se pasó como pwszVersion debe comenzar con el carácter "v" seguido de las tres primeras partes del número de versión (por ejemplo, "v1.0.1529").

Algunas versiones de CLR se instalan con una instrucción de directiva que especifica la compatibilidad con versiones anteriores de CLR. 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 el valor STARTUP_LOADER_SAFEMODE para el parámetro startupFlags.

Si el llamador especifica null como valor de pwszVersion, se cargará la versión más reciente de CLR. 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 este planteamiento 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 CLR para servidor o para estación de trabajo. Los valores válidos son svr y wks. La versión para servidor está optimizada para aprovechar las ventajas que aportan varios procesadores al realizar recolecciones de elementos no utilizados, mientras que la versión para estación de trabajo está optimizada para las aplicaciones cliente que se ejecutan en equipos con un solo procesador.

Si se establece pwszBuildFlavoren 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 estación de trabajo, incluso aunque pwszBuildFlavoresté establecido en svr. Sin embargo, si pwszBuildFlavorse establece en svr y se especifica la recolección simultánea de elementos no utilizados (vea la descripción del parámetro startupFlags), se cargará la versión para servidor.

Nota

No se admite la recolección simultánea de elementos no utilizados en aplicaciones en las que se ejecuta el emulador WOW64 x86 en sistemas de 64 bits y que implementan la arquitectura Intel Itanium (denominada anteriormente IA-64). Para obtener más información sobre el uso de WOW64 en sistemas Windows de 64 bits, vea Running 32-bit Applications.
pwszHostConfigFile
[in] Nombre de un archivo de configuración de host que especifica la versión de CLR que se debe cargar. Si el nombre de archivo no incluye una ruta de acceso completa, se supone que este se encuentra en el mismo directorio que el ejecutable que realiza la llamada.
pReserved
[in] Reservado para extensibilidad futura.
startupFlags
[in] Conjunto de marcadores 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 no se establece ningún marcador, el valor predeterminado es un dominio único. Se admiten los siguientes valores:
- STARTUP_CONCURRENT_GC: especifica que se debería utilizar la recolección simultánea de elementos no utilizados. Si el llamador solicita la versión para servidor y especifica la recolección simultánea de elementos no utilizados en un equipo con un solo procesador, se utilizan, en su lugar, la versión para estación de trabajo y la recolección no simultánea de elementos no utilizados.
- STARTUP_LOADER_OPTIMIZATION_SINGLE_DOMAIN: especifica que no se cargue ningún ensamblado como neutral para el dominio.
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN: especifica que se carguen todos los ensamblados como neutrales para el dominio.
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN_HOST: especifica que se carguen todos los ensamblados con nombre seguro como neutrales para el dominio.
- STARTUP_LOADER_SAFEMODE: especifica que se cargará la versión de CLR exacta que se pasó en pwszVersion. El proceso intermedio ("shim") no evalúa directivas para determinar la última versión compatible.
rclsid
[in] El CLSID de la coclase que implementa la interfaz que se busca. Los valores admitidos son CLSID_CorRuntimeHost o null.
riid
[in] El IID de la interfaz solicitada. Los valores admitidos para la versión inicial del motor en tiempo de ejecución son IID_ICorRuntimeHost o null.
ppv
[out] Puntero de interfaz a la versión del motor en tiempo de ejecución que se cargó.