Função LockClrVersion

Permite que o host determine qual versão do Common Language Runtime (CLR) será usada no processo antes de inicializar explicitamente o CLR.

Essa função foi preterida no .NET Framework 4.

Sintaxe

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

Parâmetros

hostCallback
[in] A função a ser chamada pelo CLR na inicialização.

pBeginHostSetup
[in] A função a ser chamada pelo host para informar ao CLR que a inicialização está sendo iniciada.

pEndHostSetup
[in] A função a ser chamada pelo host para informar ao CLR que a inicialização foi concluída.

Valor Retornado

Esse método retorna códigos de erro COM padrão, conforme definido em WinError.h, além dos valores a seguir.

Comentários

O host chama LockClrVersion antes de inicializar o CLR. LockClrVersion usa três parâmetros, todos os quais são retornos de chamada do tipo FLockClrVersionCallback. Este tipo é definido da seguinte forma.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();  

As etapas a seguir ocorrem na inicialização do tempo de execução:

1. O host chama CorBindToRuntimeEx ou uma das outras funções de inicialização de runtime. Como alternativa, o host pode inicializar o runtime usando a ativação de objeto COM.

2. O runtime chama a função especificada pelo hostCallback parâmetro.

3. A função especificada por hostCallback então faz a seguinte sequência de chamadas:

   • A função especificada pelo pBeginHostSetup parâmetro.

   • CorBindToRuntimeEx (ou outra função de inicialização de runtime).

   • ICLRRuntimeHost::SetHostControl.

   • ICLRRuntimeHost::Start.

   • A função especificada pelo pEndHostSetup parâmetro.

Todas as chamadas de pBeginHostSetup para pEndHostSetup devem ocorrer em um único thread ou fibra, com a mesma pilha lógica. Esse thread pode ser diferente do thread no qual hostCallback é chamado.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: MSCorEE.h

Biblioteca: MSCorEE.dll

Versões do .NET Framework: disponíveis desde 2.0

Confira também

• Funções de hospedagem CLR reprovadas