Método IHostControl::GetHostManager
Obtém um ponteiro de interface para a implementação da interface do anfitrião com o especificado IID
.
Sintaxe
HRESULT GetHostManager (
[in] REFIID riid,
[out, iid_is(riid)] void** ppObject
);
Parâmetros
riid
[in] A IID
interface para a qual o common language runtime (CLR) está a consultar.
ppObject
[fora] Um ponteiro para a interface implementada pelo anfitrião ou nulo se o anfitrião não suportar esta interface.
Devolver Valor
HRESULT | Description |
---|---|
S_OK | GetHostManager devolvido com êxito. |
HOST_E_CLRNOTAVAILABLE | O CLR não foi carregado para um processo ou o CLR está num estado em que não pode executar o código gerido ou processar a chamada com êxito. |
HOST_E_TIMEOUT | A chamada excedeu o limite de tempo. |
HOST_E_NOT_OWNER | O autor da chamada não é o proprietário do bloqueio. |
HOST_E_ABANDONED | Um evento foi cancelado enquanto um thread ou fibra bloqueado estava à espera. |
E_FAIL | Ocorreu uma falha catastrófica desconhecida. Quando um método devolve E_FAIL, o CLR já não é utilizável no processo. As chamadas subsequentes para métodos de alojamento devolvem HOST_E_CLRNOTAVAILABLE. |
E_INVALIDARG | O pedido IID não é válido. |
E_NOINTERFACE | A interface pedida não é suportada. |
Observações
O CLR consulta o anfitrião para determinar se suporta uma ou mais das seguintes interfaces:
Se o anfitrião suportar a interface especificada, define ppObject
para a implementação dessa interface. Caso contrário, é definido ppObject
como nulo.
O CLR não chama Release
os gestores de anfitriões, mesmo quando o encerra.
Requisitos
Plataformas: Veja Requisitos de Sistema.
Cabeçalho: MSCorEE.h
Biblioteca: Incluído como um recurso no MSCorEE.dll
.NET Framework Versões: Disponível desde 2.0