ICLRRuntimeHost::SetHostControl, méthode

Article
08/10/2011

Définit le pointeur d'interface que le Common Language Runtime (CLR) peut utiliser pour obtenir l'implémentation par l'hôte de IHostControl, interface.

HRESULT SetHostControl(
    [in] IHostControl* pHostControl
);

Paramètres

pHostControl
[in] Pointeur d'interface vers l'implémentation de l'hôte de IHostControl, interface.

Valeur de retour

HRESULT	Description
S_OK	SetHostControl a été retourné avec succès.
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.
E_CLR_ALREADY_STARTED	Le CLR a déjà été initialisé.

Notes

Vous devez appeler SetHostControl avant que le CLR soit initialisé, autrement dit, avant d'appeler ICLRRuntimeHost::Start, méthode ou d'utiliser l'une des Interfaces de métadonnées. Il est conseillé d'appeler SetHostControl immédiatement après un appel à CorBindToCurrentRuntime, fonction ou CorBindToRuntimeEx, fonction.