IHostControl::GetHostManager – metoda

Získá ukazatel rozhraní na hostitel implementaci rozhraní se zadaným IID.

Syntaxe

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

Parametry

riid
[v] Rozhraní IID , na které se dotazuje modul CLR (Common Language Runtime).

ppObject
[out] Ukazatel na rozhraní implementované hostitelem nebo null, pokud hostitel nepodporuje toto rozhraní.

Návratová hodnota

HRESULT	Description
S_OK	GetHostManager úspěšně vráceno.
HOST_E_CLRNOTAVAILABLE	ClR nebyl načten do procesu nebo clr je ve stavu, ve kterém nemůže spustit spravovaný kód nebo úspěšně zpracovat volání.
HOST_E_TIMEOUT	Časový limit hovoru vypršel.
HOST_E_NOT_OWNER	Volající zámek nevlastní.
HOST_E_ABANDONED	Událost byla zrušena, zatímco na ni čekalo blokované vlákno nebo vlákno.
E_FAIL	Došlo k neznámému závažnému selhání. Když metoda vrátí E_FAIL, clr již není možné v rámci procesu použít. Následná volání metod hostování vrátí HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG	Požadovaný kód IID není platný.
E_NOINTERFACE	Požadované rozhraní není podporováno.

Poznámky

ClR se dotazuje hostitele, aby zjistil, jestli podporuje jedno nebo více z následujících rozhraní:

• IHostMemoryManager

• IHostTaskManager

• IHostThreadPoolManager

• IHostIoCompletionManager

• IHostSyncManager

• IHostAssemblyManager

• IHostGCManager

• IHostPolicyManager

• IHostSecurityManager

Pokud hostitel podporuje zadané rozhraní, nastaví ppObject svou implementaci tohoto rozhraní. V opačném případě se nastaví ppObject na hodnotu null.

ClR nevolá Release správce hostitelů, a to ani v případě, že ho vypnete.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: MSCorEE.h

Knihovny: Zahrnutý jako prostředek v MSCorEE.dll

Verze rozhraní .NET Framework: K dispozici od verze 2.0

Viz také

• IHostControl – rozhraní