CorBindToRuntime (Función)

Artículo
10/07/2008

Actualización: noviembre 2007

Permite a los hosts no administrados cargar Common Language Runtime (CLR) en un proceso.

HRESULT CorBindToRuntime (
        [in]  LPCWSTR     pwszVersion, 
        [in]  LPCWSTR     pwszBuildFlavor, 
        [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 flags, como se describe a continuación.

Si el llamador especifica null como valor de pwszVersion, se cargará la versión más reciente del motor en tiempo de ejecución. 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 flags), se cargará la versión para servidor.
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 devuelve un valor HRESULT de CLR_E_SHIM_RUNTIMELOAD.

Flujo y contexto de ejecución de la identidad de Windows

En la versión 1 de CLR, el objeto WindowsIdentity no fluye por puntos asincrónicos, como nuevos subprocesos, grupos de subprocesos o devoluciones de llamada de temporizador. En la versión 2.0 de CLR, el objeto ExecutionContext ajusta cierta información sobre el subproceso en ejecución y hace que fluya por cualquier punto asincrónico, pero no por los límites del dominio de aplicación. De igual forma, el objeto WindowsIdentity también fluye por cualquier punto asincrónico. Por consiguiente, también fluye la suplantación actual en el subproceso, si la hubiera.

El flujo puede modificarse de dos maneras:

Si se modifica la configuración de ExecutionContext para suprimir el flujo por subproceso (vea los métodos SuppressFlow, SuppressFlow y SuppressFlowWindowsIdentity).
Si se cambia el modo predeterminado del proceso al modo de compatibilidad de la versión 1, donde el objeto WindowsIdentity no fluye por cualquier punto asincrónico, independientemente de los valores de ExecutionContext en el subproceso actual. La manera de cambiar el modo predeterminado depende de si se utiliza un archivo ejecutable administrado o una interfaz de alojamiento no administrada para cargar CLR:
1. Para los archivos ejecutables administrados, se debe establecer el atributo enabled del elemento <legacyImpersonationPolicy> en true.
2. Para las interfaces de hospedaje no administradas, se establece el marcador STARTUP_LEGACY_IMPERSONATION en el parámetro flags al llamar a la función CorBindToRuntimeEx.
El modo de compatibilidad de la versión 1 se aplica a todo el proceso y a todos los dominios de aplicación del proceso.

Comentarios

CorBindToRuntimeEx y CorBindToRuntime realizan la misma operación, pero la función CorBindToRuntimeEx permite establecer marcadores para especificar el comportamiento de CLR.