Método IHostControl::GetHostManager
Obtém um ponteiro de interface para a implementação da interface do host com o IID especificado.
Sintaxe
HRESULT GetHostManager (
[in] REFIID riid,
[out, iid_is(riid)] void** ppObject
);
Parâmetros
riid
[in] O IID da interface para a qual o CLR (Common Language Runtime) está consultando.
ppObject
[out] Um ponteiro para a interface implementada pelo host ou nulo se o host não der suporte a essa interface.
Valor Retornado
| HRESULT | Descrição |
|---|---|
| S_OK | GetHostManager 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 código gerenciado ou processar a chamada com êxito. |
| HOST_E_TIMEOUT | Uma chamada atingiu o tempo limite. |
| HOST_E_NOT_OWNER | O chamador não possui o bloqueio. |
| HOST_E_ABANDONED | Um evento foi cancelado enquanto uma fibra ou um thread bloqueado estava esperando por ele. |
| E_FAIL | Uma falha catastrófica desconhecida ocorreu. Quando um método retorna E_FAIL, o CLR não pode mais ser usado no processo. Chamadas subsequentes para métodos de hospedagem retornam HOST_E_CLRNOTAVAILABLE. |
| E_INVALIDARG | O IID solicitado não é válido. |
| E_NOINTERFACE | Não há suporte para a interface solicitada. |
Comentários
O CLR consulta o host para determinar se ele dá suporte a uma ou mais das seguintes interfaces:
Se o host der suporte à interface especificada, ele definirá ppObject para a implementação dessa interface. Caso contrário, ele definirá ppObject como nulo.
O CLR não chama Release nos gerentes de host, mesmo quando você o encerra.
Requisitos
Plataformas: confira Requisitos do sistema.
Cabeçalho: MSCorEE.h
Biblioteca: incluída como um recurso no MSCorEE.dll
Versões do .NET Framework: disponíveis desde 2.0
