Compartilhar via


ICLRRuntimeHost::SetHostControl Method

Define o ponteiro da interface que o CLR (Common Language Runtime) pode usar para obter a implementação do host da Interface IHostControl.

Syntax

HRESULT SetHostControl(
    [in] IHostControl* pHostControl
);

Parameters

pHostControl [in] Um ponteiro de interface para a implementação da Interface IHostControl do host.

Return Value

HRESULT Description
S_OK SetHostControl retornado com êxito.
HOST_E_CLRNOTAVAILABLE O CLR não foi carregado em um processo ou o CLR está em um estado no qual não pode executar o código gerenciado ou processar a chamada com êxito.
HOST_E_TIMEOUT A chamada atingiu o tempo limite.
HOST_E_NOT_OWNER O chamador não possui o bloqueio.
HOST_E_ABANDONED Um evento foi cancelado enquanto um thread ou fibra bloqueado estava esperando por ele.
E_FAIL Ocorreu uma falha catastrófica desconhecida. Se um método retornar E_FAIL, o CLR não será mais utilizável dentro do processo. Chamadas subsequentes para métodos de hospedagem retornam HOST_E_CLRNOTAVAILABLE.
E_CLR_ALREADY_STARTED O CLR já foi inicializado.

Remarks

Você deve chamar SetHostControl antes que o CLR seja inicializado, ou seja, antes de chamar o Método Start ou usar qualquer uma das Interfaces de Metadados. É recomendável que você chame SetHostControl imediatamente depois de chamar a Função CorBindToCurrentRuntime ou a Função CorBindToRuntimeEx.

Requirements

Plataformas: confira Requisitos do sistema.

Header: MSCorEE.h

Biblioteca: Incluído como um recurso no MSCorEE.dll

versões do .NET Framework: disponíveis desde 2.0

See also