IHostControl::GetHostManager-Methode

Ruft einen Schnittstellenzeiger auf die Hostimplementierung der Schnittstelle mit der angegebenen IID ab.

HRESULT GetHostManager (
    [in] REFIID riid,
    [out, iid_is(riid)] void** 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	Beschreibungen
S_OK	GetHostManager erfolgreich zurückgegeben.
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.

• IHostMemoryManager

• IHostTaskManager

• IHostThreadPoolManager

• IHostIoCompletionManager

• IHostSyncManager

• IHostAssemblyManager

• IHostGCManager

• IHostPolicyManager

• IHostSecurityManager

Wenn der Host die angegebene Schnittstelle unterstützt, legt er ppObject auf seine Implementierung dieser Schnittstelle fest. Andernfalls wird ppObject auf NULL gesetzt.

Die CLR ruft Release auf Hostmanagern nicht auf, auch wenn Sie sie schließen.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: MSCorEE.h

Bibliothek: als Ressource in MSCorEE.dll enthalten

.NET Framework-Versionen: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Siehe auch

Referenz

IHostControl-Schnittstelle

Änderungsprotokoll

Datum	Versionsgeschichte	Grund
Dezember 2010	Erläutert, dass Release nie für Hostmanager aufgerufen wird.	Korrektur inhaltlicher Fehler.