Metodo IHostControl::GetHostManager

Ottiene un puntatore a interfaccia all'implementazione dell'interfaccia dell'host con il valore IID specificato.

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

Parametri

• riid
  [in] Valore IID dell'interfaccia per il quale Common Language Runtime (CLR) esegue una query.

• ppObject
  [out] Puntatore all'interfaccia implementata dall'host oppure a null se l'host non supporta questa interfaccia.

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	GetHostManager ha restituito correttamente un valore.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata.
HOST_E_TIMEOUT	Timeout della chiamata.
HOST_E_NOT_OWNER	Il chiamante non è il proprietario del blocco.
HOST_E_ABANDONED	Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento.
E_FAIL	Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, CLR non sarà più utilizzabile all'interno del processo. Le successive chiamate ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG	L'IID richiesto non è valido.
E_NOINTERFACE	L'interfaccia richiesta non è supportata.

Note

Common Language Runtime esegue una query per determinare se l'host supporta una o più delle seguenti interfacce:

• IHostMemoryManager

• IHostTaskManager

• IHostThreadPoolManager

• IHostIoCompletionManager

• IHostSyncManager

• IHostAssemblyManager

• IHostGCManager

• IHostPolicyManager

• IHostSecurityManager

Se l'host supporta l'interfaccia specificata, ppObject viene impostato sulla relativa implementazione di tale interfaccia. In caso contrario, ppObject viene impostato su null.

CLR non chiama Release sugli amministratori dell'host, anche quando lo si chiude.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: inclusa come risorsa in MSCorEE.dll

Versioni di .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vedere anche

Riferimenti

Interfaccia IHostControl

Cronologia delle modifiche

Data	Cronologia	Motivo
Dicembre 2010	Chiarimento relativo a Release che non è mai chiamato sui gestori dell'host.	Correzione di bug nel contenuto.