IHostControl::GetHostManager — Metoda

Pobiera wskaźnik interfejsu do implementacji interfejsu hosta z określonym IID.

Składnia

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

Parametry

riid
[in] Interfejs IID , dla którego jest używane środowisko uruchomieniowe języka wspólnego (CLR, Common Language Runtime).

ppObject
[out] Wskaźnik do interfejsu zaimplementowanego przez hosta lub wartość null, jeśli host nie obsługuje tego interfejsu.

Wartość zwracana

HRESULT	Opis
S_OK	GetHostManager zwrócone pomyślnie.
HOST_E_CLRNOTAVAILABLE	ClR nie został załadowany do procesu lub CLR jest w stanie, w którym nie może uruchomić zarządzanego kodu lub przetworzyć wywołania pomyślnie.
HOST_E_TIMEOUT	Upłynął limit czasu wywołania.
HOST_E_NOT_OWNER	Obiekt wywołujący nie jest właścicielem blokady.
HOST_E_ABANDONED	Zdarzenie zostało anulowane, gdy zablokowany wątek lub światłowod czekał na nie.
E_FAIL	Wystąpił nieznany katastrofalny błąd. Gdy metoda zwraca E_FAIL, clR nie będzie już można jej używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG	Żądany element IID jest nieprawidłowy.
E_NOINTERFACE	Żądany interfejs nie jest obsługiwany.

Uwagi

ClR wysyła zapytanie do hosta, aby określić, czy obsługuje jeden lub więcej z następujących interfejsów:

• IHostMemoryManager

• IHostTaskManager

• IHostThreadPoolManager

• IHostIoCompletionManager

• IHostSyncManager

• IHostAssemblyManager

• IHostGCManager

• IHostPolicyManager

• IHostSecurityManager

Jeśli host obsługuje określony interfejs, ustawia ppObject jego implementację. W przeciwnym razie ustawia wartość ppObject null.

CLR nie wywołuje Release menedżerów hostów, nawet po jego zamknięciu.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: MSCorEE.h

Biblioteki: Uwzględnione jako zasób w MSCorEE.dll

wersje .NET Framework: dostępne od wersji 2.0

Zobacz też

• IHostControl — Interfejs