Metodo IHostControl::GetHostManager

  • Articolo

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

Vedi anche