ICLRControl::GetCLRManager, méthode

Article
08/10/2011

Obtient un pointeur d'interface vers une instance de l'un des types de gestionnaires que l'hôte peut utiliser pour configurer le Common Language Runtime (CLR).

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

Paramètres

riid
[in] IID du type de gestionnaire à retourner. Les valeurs suivantes IID sont prises en charge.
- IID_ICLRDebugManager : spécifie que ppObject sera de type ICLRDebugManager.
- IID_ICLRErrorReportingManager : Spécifie que ppObject sera de type ICLRErrorReportingManager.
- IID_ICLRGCManager : spécifie que ppObject sera de type ICLRGCManager.
- IID_ICLRHostProtectionManager : spécifie que ppObject sera de type ICLRHostProtectionManager.
- IID_ICLROnEventManager : spécifie que ppObject sera de type ICLROnEventManager.
- IID_ICLRPolicyManager : spécifie que ppObject sera de type ICLRPolicyManager.
- IID_ICLRTaskManager : Spécifies que ppObject sera de type ICLRTaskManager.
ppObject
[out] Pointeur d'interface vers le gestionnaire demandé ou null, si un type de gestionnaire non valide a été demandé.

Valeur de retour

HRESULT	Description
S_OK	Retour réussi de la méthode.
HOST_E_CLRNOTAVAILABLE	Le CLR n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès.
HOST_E_TIMEOUT	L'appel a expiré.
HOST_E_NOT_OWNER	L'appelant ne possède pas le verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu'un thread bloqué ou une fibre l'attendait.
E_FAIL	Une défaillance grave et inconnue s'est produite. Lorsqu'une méthode retourne E_FAIL, le CLR n'est plus utilisable dans le processus. Les appels suivants aux méthodes d'hébergement retournent HOST_E_CLRNOTAVAILABLE.
E_NOINTERFACE	Le type d'interface n'est pas pris en charge.