Função LockClrVersion

Artigo
04/11/2023

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:

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.
O runtime chama a função especificada pelo hostCallback parâmetro.
A função especificada por hostCallback essa altura faz a seguinte sequência de chamadas:
- A função especificada pelo pBeginHostSetup parâmetro.
- CorBindToRuntimeEx (ou outra função de inicialização do runtime).
- ICLRRuntimeHost::SetHostControl.
- ICLRRuntimeHost::Start.
- A função especificada pelo pEndHostSetup parâmetro.

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

Funções de Alojamento CLR preteridas

Partilhar via