IHostControl::GetHostManager-Methode
Ruft einen Schnittstellenzeiger auf die Implementierung der Schnittstelle des Hosts mit der angegebenen IID ab.
Syntax
HRESULT GetHostManager (
[in] REFIID riid,
[out, iid_is(riid)] void** ppObject
);
Parameter
riid
[in] Die IID der Schnittstelle, die 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 wurde erfolgreich zurückgegeben. |
| HOST_E_CLRNOTAVAILABLE | Die CLR wurde nicht in einen Prozess geladen, oder die CLR befindet sich in einem Zustand, in dem sie keinen verwalteten Code ausführen oder den Aufruf nicht erfolgreich verarbeiten kann. |
| HOST_E_TIMEOUT | Timeout des Aufrufs. |
| HOST_E_NOT_OWNER | Der Aufrufer besitzt die Sperre nicht. |
| HOST_E_ABANDONED | Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber darauf gewartet hat. |
| E_FAIL | Es ist ein unbekannter katastrophaler Fehler aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR nicht mehr innerhalb des Prozesses verwendet werden. Nachfolgende Aufrufe von Hostingmethoden geben HOST_E_CLRNOTAVAILABLE zurück. |
| E_INVALIDARG | Die angeforderte IID ist ungültig. |
| E_NOINTERFACE | Die angeforderte Schnittstelle wird nicht unterstützt. |
Bemerkungen
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, wird ppObject auf die Implementierung dieser Schnittstelle festgelegt. Andernfalls wird ppObject auf NULL festgelegt.
Die CLR ruft Release nicht für Host-Manager auf, auch wenn Sie sie herunterfahren.
Anforderungen
Plattformen: Informationen finden Sie unter Systemanforderungen.
Header: MSCorEE.h
Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.
.NET Framework-Versionen: Seit 2.0 verfügbar.
