Функция LockClrVersion

  • Статья

Позволяет узлу определить, какая версия среды CLR будет использоваться в процессе перед явной инициализацией среды CLR.

Эта функция устарела в платформа .NET Framework 4.

Синтаксис

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

Параметры

hostCallback
[in] Функция, вызываемая средой CLR при инициализации.

pBeginHostSetup
[in] Функция, вызываемая узлом для информирования среды CLR о начале инициализации.

pEndHostSetup
[in] Функция, вызываемая узлом для информирования среды CLR о завершении инициализации.

Возвращаемое значение

Этот метод возвращает стандартные коды ошибок COM, как определено в WinError.h, в дополнение к следующим значениям.

Код возврата Описание
S_OK Метод завершился успешно.
E_INVALIDARG Один или несколько аргументов имеет значение NULL.

Комментарии

Узел вызывает LockClrVersion перед инициализацией среды CLR. LockClrVersion принимает три параметра, все из которых являются обратными вызовами типа FLockClrVersionCallback. Этот тип определяется следующим образом.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();

При инициализации среды выполнения выполняются следующие действия.

  1. Узел вызывает CorBindToRuntimeEx или одну из других функций инициализации среды выполнения. Кроме того, узел может инициализировать среду выполнения с помощью активации COM-объектов.

  2. Среда выполнения вызывает функцию, заданную параметром hostCallback .

  3. Функция, указанная параметром hostCallback , выполняет следующую последовательность вызовов:

    • Функция, заданная параметром pBeginHostSetup .

    • CorBindToRuntimeEx (или другая функция инициализации среды выполнения).

    • ICLRRuntimeHost::SetHostControl.

    • ICLRRuntimeHost::Start.

    • Функция, заданная параметром pEndHostSetup .

Все вызовы из to pBeginHostSetuppEndHostSetup должны выполняться в одном потоке или волокно с одним и тем же логическим стеком. Этот поток может отличаться от потока, для которого hostCallback вызывается .

Требования

Платформы: см. раздел Требования к системе.

Заголовка: MSCorEE.h

Библиотека: MSCorEE.dll

версии платформа .NET Framework: доступно с версии 2.0.

См. также раздел