IHostControl::GetHostManager-Methode
Aktualisiert: November 2007
Ruft einen Schnittstellenzeiger auf die Hostimplementierung der Schnittstelle mit der angegebenen IID ab.
HRESULT GetHostManager (
[in] REFIID riid,
[out, iid_is(riid)] IUnknown** ppObject
);
Parameter
riid
[in] Die IID der Schnittstelle, welche die Common Language Runtime (CLR) abfragt.ppObject
[out] Ein Zeiger auf die vom Host implementierte Schnittstelle oder NULL, wenn der Host diese Schnittstelle nicht unterstützt.
Rückgabewert
HRESULT |
Beschreibung |
|---|---|
S_OK |
GetHostManager kehrte erfolgreich zurück. |
HOST_E_CLRNOTAVAILABLE |
Die CLR wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann. |
HOST_E_TIMEOUT |
Der Aufruf hat das Zeitlimit überschritten. |
HOST_E_NOT_OWNER |
Der Aufrufer ist nicht Besitzer der Sperre. |
HOST_E_ABANDONED |
Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat. |
E_FAIL |
Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück. |
E_INVALIDARG |
Die angeforderte IID ist nicht gültig. |
E_NOINTERFACE |
Die angeforderte Schnittstelle wird nicht unterstützt. |
Hinweise
Die CLR fragt den Host ab, um zu ermitteln, ob er eine oder mehrere der folgenden Schnittstellen unterstützt.
Wenn der Host die angegebene Schnittstelle unterstützt, legt er ppObject auf seine Implementierung dieser Schnittstelle fest. Andernfalls wird ppObject auf NULL gesetzt.
Anforderungen
Plattformen: siehe Systemanforderungen für .NET Framework.
Header: MSCorEE.idl
Bibliothek: als Ressource in MSCorEE.dll enthalten
.NET Framework-Versionen: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0