IHostControl::GetHostManager metódus

Lekéri a kezelőfelület mutatóját a megadott IIDfelület gazdagépi implementációjára.

Szintaxis

HRESULT GetHostManager (  
    [in] REFIID riid,  
    [out, iid_is(riid)] void** ppObject  
);  

Paraméterek

riid
[in] Annak IID a felületnek a felülete, amelyet a közös nyelvi futtatókörnyezet (CLR) lekérdez.

ppObject
[kifelé] Mutató a gazdagép által implementált felületre, vagy null értékű, ha a gazdagép nem támogatja ezt a felületet.

Visszatérési érték

HRESULT	Description
S_OK	GetHostManager sikeresen visszaadott.
HOST_E_CLRNOTAVAILABLE	A CLR nincs betöltve egy folyamatba, vagy a CLR olyan állapotban van, amelyben nem tudja futtatni a felügyelt kódot, vagy nem tudja sikeresen feldolgozni a hívást.
HOST_E_TIMEOUT	A hívás túllépte az időkorlátot.
HOST_E_NOT_OWNER	A hívó nem rendelkezik a zárral.
HOST_E_ABANDONED	Egy esemény megszakadt, miközben egy blokkolt szál vagy szál várt rá.
E_FAIL	Ismeretlen katasztrofális hiba történt. Amikor egy metódus E_FAIL ad vissza, a CLR már nem használható a folyamaton belül. Az üzemeltetési módszerek későbbi hívásai HOST_E_CLRNOTAVAILABLE ad vissza.
E_INVALIDARG	A kért IID érvénytelen.
E_NOINTERFACE	A kért felület nem támogatott.

Megjegyzések

A CLR lekérdezi a gazdagépet annak megállapításához, hogy támogatja-e az alábbi felületek közül egy vagy több használatát:

• IHostMemoryManager

• IHostTaskManager

• IHostThreadPoolManager

• IHostIoCompletionManager

• IHostSyncManager

• IHostAssemblyManager

• IHostGCManager

• IHostPolicyManager

• IHostSecurityManager

Ha a gazdagép támogatja a megadott felületet, az ennek a felületnek a megvalósítását állítja ppObject be. Ellenkező esetben null értékre van adva ppObject .

A CLR nem hívja meg Release a gazdagép-kezelőket, még akkor sem, ha ön leállítja.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: MSCorEE.h

Könyvtár: Erőforrásként szerepel a MSCorEE.dll

.NET-keretrendszer verziók: 2.0 óta elérhető

Lásd még

• IHostControl felület