Share via

LockClrVersion (Función)

  • Artículo

Permite al host determinar la versión de Common Language Runtime (CLR) que se utilizará en el proceso antes de inicializar CLR de forma explícita.

Esta función está desusada en .NET Framework versión 4.

HRESULT LockClrVersion (
    [in] FLockClrVersionCallback   hostCallback,
    [in] FLockClrVersionCallback  *pBeginHostSetup,
    [in] FLockClrVersionCallback  *pEndHostSetup
);

Parámetros

  • hostCallback
    [in] Función a la que llamará CLR en la inicialización.

  • pBeginHostSetup
    [in] Función a la que llamará el host para informar a CLR de que ha comenzado la inicialización.

  • pEndHostSetup
    [in] Función a la que llamará el host para informar a CLR de que se ha completado la inicialización.

Valor devuelto

Este método devuelve los códigos de error COM estándar definidos en WinError.h, además de los valores siguientes.

Código devuelto

Descripción

S_OK

El método se ha ejecutado correctamente.

E_INVALIDARG

Uno o varios argumentos tienen un valor null.

Comentarios

El host llama a LockClrVersion antes de inicializar el CLR. LockClrVersion toma tres parámetros, todos los cuales son devoluciones de llamada de tipo FLockClrVersionCallback. Este tipo se define como sigue.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();

Al inicializar el motor en tiempo de ejecución se realizan los pasos siguientes:

  1. El host llama a CorBindToRuntimeEx o a otra de las funciones de inicialización del motor en tiempo de ejecución. Opcionalmente, el host puede inicializar el motor en tiempo de ejecución utilizando la activación de objetos COM.

  2. El motor en tiempo de ejecución llama a la función especificada por el parámetro hostCallback.

  3. A continuación, la función especificada por hostCallback realiza la siguiente secuencia de llamadas:

    • La función especificada por el parámetro pBeginHostSetup.

    • CorBindToRuntimeEx (u otra función de inicialización del motor en tiempo de ejecución).

    • ICLRRuntimeHost::SetHostControl.

    • ICLRRuntimeHost::Start.

    • La función especificada por el parámetro pEndHostSetup.

Todas las llamadas realizadas desde pBeginHostSetup a pEndHostSetup deben realizarse en un único subproceso o fibra, con la misma pila lógica. Este subproceso puede ser diferente del subproceso en el que se llama a hostCallback.

Requisitos

Plataformas: vea Requisitos de sistema de .NET Framework.

Encabezado: MSCorEE.h

Biblioteca: MSCorEE.dll

Versiones de .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vea también

Otros recursos

Funciones estáticas globales de hospedaje de .NET Framework 1.1 y 2.0