Partilhar via

Função LockClrVersion

Permite ao anfitrião determinar que versão do runtime de idioma comum (CLR) será utilizada no processo antes de inicializar explicitamente o CLR.

Esta 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 após a inicialização.

pBeginHostSetup
[in] A função a ser chamada pelo anfitrião para informar o CLR de que a inicialização está a começar.

pEndHostSetup
[in] A função a ser chamada pelo anfitrião para informar o CLR de que a inicialização está concluída.

Devolver Valor

Este método devolve códigos de erro COM padrão, conforme definido em WinError.h, para além dos seguintes valores.

Código de retorno Descrição
S_OK O método foi concluído com êxito.
E_INVALIDARG Um ou mais dos argumentos são nulos.

Observações

O anfitrião chama LockClrVersion antes de inicializar o CLR. LockClrVersion utiliza três parâmetros, todos os quais são chamadas de retorno do tipo FLockClrVersionCallback. Este tipo é definido da seguinte forma.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();

Os passos seguintes ocorrem após a inicialização do runtime:

  1. O anfitrião chama CorBindToRuntimeEx ou uma das outras funções de inicialização do runtime. Em alternativa, o anfitrião pode inicializar o runtime com a ativação de objetos COM.

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

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

Todas as chamadas de para pEndHostSetup têm de pBeginHostSetup ocorrer num único thread ou fibra, com a mesma pilha lógica. Este thread pode ser diferente do thread no qual hostCallback é chamado.

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: MSCorEE.h

Biblioteca: MSCorEE.dll

.NET Framework Versões: Disponível desde 2.0

Ver também

  • Last updated on