Freigeben über

IHostControl::GetHostManager-Methode

  • Artikel

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.

Siehe auch