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:

• IHostMemoryManager

• IHostTaskManager

• IHostThreadPoolManager

• IHostIoCompletionManager

• IHostSyncManager

• IHostAssemblyManager

• IHostGCManager

• IHostPolicyManager

• IHostSecurityManager

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

• Interfaccia IHostControl