Função LockClrVersion

Artigo
08/25/2010

Permite que o host de determinar qual versão do common linguagem tempo de execução (CLR) será usado no processo antes de inicializar o CLR explicitamente.

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

Parâmetros

hostCallback
[in] A função a ser chamado 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 códigos de erro COM padrão, conforme definido no WinError.h, juntamente com sistema autônomo seguintes valores.

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

Comentários

O host chama LockClrVersion antes de inicializar o CLR. LockClrVersion usa três parâmetros, que são chamadas de retorno do tipo FLockClrVersionCallback. Esse tipo é definido sistema autônomo a seguir.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();

Ocorrem na inicialização do tempo de execução as seguintes etapas:

O host chama CorBindToRuntimeEx ou uma do Outros funções de inicialização em 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 em seguida, torna a sequência de chamadas a seguir:
- A função especificada pelo pBeginHostSetup parâmetro.
- CorBindToRuntimeEx (ou outra função de inicialização em tempo de execução).
- ICLRRuntimeHost::SetHostControl.
- ICLRRuntimeHost::Start.
- A função especificada pelo pEndHostSetup parâmetro.

Todas as chamadas de pBeginHostSetup para pEndHostSetup deve 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: See Requisitos de sistema do .NET framework.

Cabeçalho: MSCorEE.idl

Biblioteca: MSCorEE.dll

.NET Framework Versions: 3.5 SP1, 3,5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Consulte também

Outros recursos

Hospedagem estático funções global

Compartilhar via