ICLRRuntimeHost::GetCLRControl, méthode

Article
08/22/2008

Mise à jour : novembre 2007

Obtient un pointeur d'interface de type ICLRControl que les hôtes peuvent utiliser pour personnaliser des aspects du Common Language Runtime (CLR).

HRESULT GetCLRControl(
    [out] ICLRControl** pCLRControl
);

Paramètres

pCLRControl
[out] Pointeur d'interface de type ICLRControl qui permet aux hôtes de configurer des aspects supplémentaires du CLR.

Valeur de retour

HRESULT	Description
S_OK	GetCLRControl a été retourné correctement.
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. Si une méthode retourne E_FAIL, le CLR n'est plus utilisable au sein du processus. Les appels suivants aux méthodes d'hébergement retournent HOST_E_CLRNOTAVAILABLE.
HOST_E_INVALIDOPERATION	Le CLR a déjà démarré.

Notes

ICLRControl fournit la méthode ICLRControl::GetCLRManager, méthode qui permet à l'hôte d'obtenir un pointeur d'interface vers un des types de gestionnaire.