Metodo IHostControl::GetHostManager
Ottiene un puntatore dell'interfaccia all'implementazione dell'host dell'interfaccia con l'oggetto specificato IID
.
Sintassi
HRESULT GetHostManager (
[in] REFIID riid,
[out, iid_is(riid)] void** ppObject
);
Parametri
riid
[in] L'interfaccia IID
per cui common language runtime (CLR) esegue una query.
ppObject
[out] Puntatore all'interfaccia implementata dall'host o null se l'host non supporta questa interfaccia.
Valore restituito
HRESULT | Descrizione |
---|---|
S_OK | GetHostManager restituito correttamente. |
HOST_E_CLRNOTAVAILABLE | ClR non è stato caricato in un processo oppure CLR si trova in uno stato in cui non è possibile eseguire codice gestito o elaborare correttamente la chiamata. |
HOST_E_TIMEOUT | Timeout della chiamata. |
HOST_E_NOT_OWNER | Il chiamante non possiede il blocco. |
HOST_E_ABANDONED | Un evento è stato annullato mentre un thread bloccato o fibra era in attesa su di esso. |
E_FAIL | Si è verificato un errore irreversibile sconosciuto. Quando un metodo restituisce E_FAIL, CLR non è più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiscono HOST_E_CLRNOTAVAILABLE. |
E_INVALIDARG | La richiesta IID non è valida. |
E_NOINTERFACE | L'interfaccia richiesta non è supportata. |
Commenti
CLR esegue una query sull'host per determinare se supporta una o più interfacce seguenti:
Se l'host supporta l'interfaccia specificata, imposta ppObject
l'implementazione di tale interfaccia. In caso contrario, imposta ppObject
su Null.
CLR non chiama Release
i gestori host, anche quando lo si arresta.
Requisiti
Piattaforme: vedere Requisiti di sistema di .NET Framework.
Intestazione: MSCorEE.h
Libreria: Incluso come risorsa in MSCorEE.dll
Versioni di .NET Framework: Disponibile da 2.0