Método de IHostControl::GetHostManager

  • Artigo

Obtém um ponteiro de interface para a implementação do host da interface com o especificado IID.

HRESULT GetHostManager (
    [in] REFIID riid,
    [out, iid_is(riid)] void** ppObject
);

Parâmetros

  • riid
    [in] O IID da interface que o common language runtime (CLR) está consultando o loop for

  • ppObject
    [out] Um ponteiro para a interface host implementado ou nulo se o host não oferece suporte a esta interface.

Valor de retorno

HRESULT

Descrição

S_OK

GetHostManagerretornado com êxito.

HOST_E_CLRNOTAVAILABLE

O CLR não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito.

HOST_E_TIMEOUT

A chamada foi esgotado.

HOST_E_NOT_OWNER

O chamador não possui o bloqueio.

HOST_E_ABANDONED

Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele.

E_FAIL

Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE.

E_INVALIDARG

Os solicitados IID não é válido.

E_NOINTERFACE

A interface solicitada não é suportada.

Comentários

O CLR consulta o host para determinar se ele suporta um ou mais das seguintes interfaces:

Se o host oferece suporte a interface especificada, ele define ppObject para sua implementação da interface. Caso contrário, ele define ppObject para null.

O CLR não chama Release sobre gerenciadores de host, mesmo quando você desligá-lo para baixo.

Requisitos

Plataformas: Consulte Requisitos de sistema do .NET Framework.

Cabeçalho: MSCorEE.h

Biblioteca: Incluído como um recurso em mscoree

.NET Framework versões: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Consulte também

Referência

Interface de IHostControl

Histórico de alterações

Date

History

Motivo

Dezembro de 2010

Esclarecida que Release nunca é chamada no host gerentes.

Correção de bug de conteúdo.