Methode IHostControl::GetHostManager
Hiermee haalt u een interfaceaanwijzer op naar de implementatie van de -interface van de host met de opgegeven IID.
Syntaxis
HRESULT GetHostManager (
[in] REFIID riid,
[out, iid_is(riid)] void** ppObject
);
Parameters
riid
[in] De IID van de interface waarop de COMMON Language Runtime (CLR) een query uitvoert.
ppObject
[uit] Een verwijzing naar de door de host geïmplementeerde interface of null als de host deze interface niet ondersteunt.
Retourwaarde
| HRESULT | Beschrijving |
|---|---|
| S_OK | GetHostManager is geretourneerd. |
| HOST_E_CLRNOTAVAILABLE | De CLR is niet geladen in een proces of de CLR bevindt zich in een status waarin beheerde code niet kan worden uitgevoerd of de aanroep kan worden verwerkt. |
| HOST_E_TIMEOUT | Er is een time-out opgetreden voor het gesprek. |
| HOST_E_NOT_OWNER | De beller is niet de eigenaar van het vergrendelingsslot. |
| HOST_E_ABANDONED | Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of vezel op wachtte. |
| E_FAIL | Er is een onbekende catastrofale fout opgetreden. Wanneer een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE. |
| E_INVALIDARG | De aangevraagde IID is ongeldig. |
| E_NOINTERFACE | De aangevraagde interface wordt niet ondersteund. |
Opmerkingen
De CLR voert een query uit op de host om te bepalen of deze ondersteuning biedt voor een of meer van de volgende interfaces:
Als de host de opgegeven interface ondersteunt, wordt de implementatie van die interface ingesteld ppObject . Anders wordt deze ingesteld ppObject op null.
De CLR roept Release geen hostmanagers aan, zelfs niet wanneer u deze afsluit.
Vereisten
Platforms: Zie Systeemvereisten.
Header: MSCorEE.h
Bibliotheek: Opgenomen als een resource in MSCorEE.dll
.NET Framework versies: beschikbaar sinds 2.0
