Compartir vía

CorBindToRuntimeHost (Función)

  • Artículo

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

Esta función está en desuso en .NET Framework 4.

Sintaxis

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 consta de cuatro partes separadas por puntos: major.minor.build.revision. La cadena que se pasó como pwszVersion debe comenzar con el carácter "v" seguido de las primeras tres 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 runtime 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 pwszVersion es null, el método no carga ninguna versión de CLR. En su lugar, devuelve CLR_E_SHIM_RUNTIMELOAD, que indica que no se cargó el runtime.

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

Si pwszBuildFlavor se establece en null, se cargará la compilación para la estación de trabajo. Cuando la ejecución se lleva a cabo en una máquina con un solo procesador, se carga siempre la compilación para la estación de trabajo, incluso aunque pwszBuildFlavor esté establecido en svr. Pero si pwszBuildFlavor se establece en svr y se especifica la recolección de elementos no utilizados simultánea (vea la descripción del parámetro startupFlags), se cargará la compilación para el servidor.

Nota

No se admite la recolección de elementos no utilizados simultánea 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 la página de ejecución de aplicaciones de 32 bits.

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 marcas que controla la recolección de elementos no utilizados simultánea, el código neutral respecto al dominio y el comportamiento del parámetro pwszVersion. Si no se establece ninguna marca, el valor predeterminado es un dominio único. Para obtener una lista de los valores admitidos, vea enumeración STARTUP_FLAGS.

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

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

ppv
[out] Puntero de interfaz a la versión del runtime que se cargó.

Requisitos

Plataformas: Vea Requisitos de sistema.

Header: MSCorEE.idl

Library: MSCorEE.dll

Versiones de .NET Framework: está disponible desde la versión 1.0

Consulte también