ICLRRuntimeHost, interface

Fournit des fonctionnalités similaires à celles de l'interface ICorRuntimeHost proposée dans la version 1 du .NET Framework, avec les changements suivants :

• l'ajout de la méthode SetHostControl pour définir l'interface de contrôle de l'hôte ;

• l'omission de certaines méthodes fournies par ICorRuntimeHost.

Méthodes

Méthode	Description
ICLRRuntimeHost::ExecuteApplication, méthode	Utilisé dans les scénarios de déploiement ClickOnce basés sur un manifeste pour spécifier l'application à activer dans un nouveau domaine.
ICLRRuntimeHost::ExecuteInAppDomain, méthode	Spécifie le AppDomain dans lequel exécuter le code managé spécifié.
ICLRRuntimeHost::ExecuteInDefaultAppDomain, méthode	Appelle la méthode spécifiée du type spécifié dans l'assembly spécifié.
ICLRRuntimeHost::GetCLRControl, méthode	Obtient un pointeur d'interface de type ICLRControl que les hôtes peuvent utiliser pour personnaliser des aspects du Common Language Runtime (CLR).
ICLRRuntimeHost::GetCurrentAppDomainId, méthode	Obtient l'identificateur numérique du AppDomain en cours d'exécution.
ICLRRuntimeHost::SetHostControl, méthode	Définit l'interface de contrôle de l'hôte. Vous devez appeler SetHostControl avant d'appeler Start.
ICLRRuntimeHost::Start, méthode	Initialise le CLR dans un processus.
ICLRRuntimeHost::Stop, méthode	Arrête l'exécution du code par le runtime.
ICLRRuntimeHost::UnloadAppDomain, méthode	Décharge le AppDomain qui correspond à l'identificateur numérique spécifié.

Notes

En commençant par le .NET Framework version 4, utilisez l'interface ICLRMetaHost pour obtenir un pointeur vers l'interface ICLRRuntimeInfo, puis appelez la méthode ICLRRuntimeInfo::GetInterface pour obtenir un pointeur vers ICLRRuntimeHost. Dans les version antérieures de .NET Framework, l'hôte obtient un pointeur vers une instance ICLRRuntimeHost en appelant CorBindToRuntimeEx ou CorBindToCurrentRuntime. Pour fournir des implémentations de chacune des technologies fournies dans le .NET Framework version 2.0, vous devez utiliser ICLRRuntimeHost à la place de ICorRuntimeHost.

Important
N'appelez pas la méthode Start avant d'appeler la méthode ExecuteApplication pour activer une application basée sur un manifeste.Si la méthode Start est appelée en premier, l'appel à la méthode ExecuteApplication échoue.

Spécifications

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : MSCorEE.h

Bibliothèque : incluse en tant que ressource dans MSCorEE.dll

Versions du .NET Framework : 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Voir aussi

Référence

CorBindToCurrentRuntime, fonction

CorBindToRuntimeEx, fonction

ICLRControl, interface

ICorRuntimeHost, interface

Coclasse CLRRuntimeHost

Concepts

Vue d'ensemble de l'hébergement

Autres ressources

Interfaces d'hébergement

Historique des modifications

Date	Historique	Motif
Juin 2010	A corrigé les instructions pour obtenir un pointeur vers l'interface.	Résolution des bogues de contenu.