Metodo ICLRControl::GetCLRManager

Articolo
08/11/2011

Ottiene un puntatore a interfaccia a un'istanza di uno qualsiasi dei tipi di gestore che l'host può utilizzare per configurare Common Language Runtime (CLR).

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

Parametri

riid
[in] IID del tipo di gestore da restituire. Sono supportati i seguenti valori IID.
- IID_ICLRDebugManager: specifica che ppObject sarà di tipo ICLRDebugManager.
- IID_ICLRErrorReportingManager: specifica che ppObject sarà di tipo ICLRErrorReportingManager.
- IID_ICLRGCManager: specifica che ppObject sarà di tipo ICLRGCManager.
- IID_ICLRHostProtectionManager: specifica che ppObject sarà di tipo ICLRHostProtectionManager.
- IID_ICLROnEventManager: specifica che ppObject sarà di tipo ICLROnEventManager.
- IID_ICLRPolicyManager: specifica che ppObject sarà di tipo ICLRPolicyManager.
- IID_ICLRTaskManager: specifica che ppObject sarà di tipo ICLRTaskManager.
ppObject
[out] Puntatore a interfaccia al gestore richiesto oppure null se è stato richiesto un tipo di gestore non valido.

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	Il metodo 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_NOINTERFACE	Il tipo dell'interfaccia non è supportato.