Compartilhar via

Função LockClrVersion

  • Artigo

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.

Código de retorno Descrição
S_OK O método foi concluído com sucesso.
E_INVALIDARG Um ou mais argumentos são inválidos.

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:

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