Método ICLRRuntimeHost::SetHostControl

Artigo
08/25/2010

Define o ponteiro de interface que o Common linguagem tempo de execução (CLR) pode ser usado para obter a implementação do host de Interface IHostControl.

HRESULT SetHostControl(
    [in] IHostControl* pHostControl
);

Parâmetros

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

Valor de retorno

HRESULT	Descrição
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 em que ele não possa executar código gerenciado ou processar a telefonar com êxito.
HOST_E_TIMEOUT	A telefonar expirou.
HOST_E_NOT_OWNER	O chamador não é proprietário do bloquear.
HOST_E_ABANDONED	Um evento foi cancelado enquanto um segmento bloqueado ou fibra estava aguardando nele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Se um método retornar E_FAIL, o CLR não é mais útil dentro do processo. As chamadas subseqüentes à hospedagem métodos retornam HOST_E_CLRNOTAVAILABLE.
E_CLR_ALREADY_STARTED	O CLR já foi inicializado.

Comentários

Você deve chamar SetHostControl antes que o CLR seja inicializado, ou seja, antes de chamar Método ICLRRuntimeHost::Start ou use qualquer um do Interfaces de metadados. É recomendável que você chamar SetHostControl imediatamente após a telefonar Função CorBindToCurrentRuntime ou Função CorBindToRuntimeEx.