Função de LockClrVersion

Artigo
08/08/2011

Permite que o host para determinar qual versão do common language runtime (CLR) será usado dentro do processo antes de inicializar explicitamente o CLR.

Essa função foi preterida na .NET Framework versão 4.

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 o CLR que a inicialização está iniciando.
pEndHostSetup
[in] A função a ser chamada pelo host para informar o CLR que a inicialização foi concluída.

Valor de retorno

Esse método retorna os códigos de erro COM padrão, conforme definido no Winerror. H, além de para os 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 nulo.

Comentários

As chamadas de host LockClrVersion antes de inicializar o CLR. LockClrVersionusa três parâmetros, os quais são os retornos de chamada do tipo FLockClrVersionCallback. Esse tipo é definido da seguinte maneira.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();

As seguintes etapas ocorrem na inicialização do runtime:

As chamadas de host CorBindToRuntimeEx ou uma das outras funções de inicialização de tempo de execução. Como alternativa, o host foi possível inicializar o tempo de execução usando a ativação do objeto COM.
O tempo de execução chama a função especificada pelo hostCallback parâmetro.
A função especificada por hostCallback faz a seguinte seqüência de chamadas:
- A função especificada pelo pBeginHostSetup parâmetro.
- CorBindToRuntimeEx(ou outra função de inicialização de tempo de execução).
- ICLRRuntimeHost::SetHostControl.
- ICLRRuntimeHost::Start.
- A função especificada pelo pEndHostSetup parâmetro.

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

Requisitos

Plataformas: Consulte Requisitos de sistema do .NET Framework.

Cabeçalho: MSCorEE.h

Biblioteca: Mscoree

.NET Framework versões: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Consulte também

Outros recursos

.NET Framework 1.1 e 2.0, hospedagem Global de funções estáticas

Partilhar via