ICLRMetaHost, interface

Fournit des méthodes qui retournent une version spécifique du common language runtime (CLR) selon son numéro de version, répertorient tous les CLR installés, répertorient toutes les exécutions chargées dans un processus spécifié, vérifient la version CLR utilisée pour compiler un assembly, ferment un processus avec un arrêt de runtime normal et interrogent une liaison d'API héritée.

Méthodes

Méthode

Description

ICLRMetaHost::EnumerateInstalledRuntimes, méthode

Retourne une énumération qui contient un pointeur d'interface ICLRRuntimeInfo valide pour chaque version du CLR installée sur un ordinateur.

ICLRMetaHost::EnumerateLoadedRuntimes, méthode

Retourne une énumération qui contient un pointeur d'interface ICLRRuntimeInfo valide pour chaque CLR chargé dans un processus donné. Cette méthode remplace GetVersionFromProcess.

ICLRMetaHost::ExitProcess, méthode

Tente d'arrêter toutes les exécutions chargées en suivant la procédure normale, puis termine le processus. Remplace la fonction CorExitProcess.

ICLRMetaHost::GetRuntime, méthode

Obtient l'interface ICLRRuntimeInfo qui correspond à une version CLR particulière. Cette méthode remplace la fonction CorBindToRuntimeEx utilisée avec l'indicateur STARTUP_LOADER_SAFEMODE.

ICLRMetaHost::GetVersionFromFile, méthode

Obtient la version de compilation du .NET Framework d'origine de l'assembly (stockée dans les métadonnées) d'après son chemin d'accès de fichier. Cette méthode remplace GetFileVersion.

ICLRMetaHost::QueryLegacyV2RuntimeBinding, méthode

Retourne une interface qui représente un runtime auquel une stratégie d'activation héritée a été liée, à l'aide, par exemple, de l'attribut useLegacyV2RuntimeActivationPolicy sur l'entrée du fichier de configuration <startup>, élément, par utilisation directe des API d'activation héritées ou en appelant la méthode ICLRRuntimeInfo::BindAsLegacyV2Runtime.

ICLRMetaHost::RequestRuntimeLoadedNotification, méthode

Garantit un rappel au pointeur fonction spécifié lorsqu'une version CLR est chargée en premier, mais n'a pas encore démarré. Cette méthode remplace LockClrVersion

Notes

La seule méthode pour obtenir une instance de cette interface consiste à appeler la fonction CLRCreateInstance comme suit :

ICLRMetaHost *pMetaHost = NULL;
HRESULT hr = CLRCreateInstance(CLSID_CLRMetaHost,
                   IID_ICLRMetaHost, (LPVOID*)&pMetaHost);

Spécifications

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : MetaHost.h

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

Versions du .NET Framework : 4

Voir aussi

Autres ressources

Interfaces d'hébergement

Hébergement (Référence des API non managées)

Historique des modifications

Date

Historique

Motif

Septembre 2010

A corrigé IID dans la liste de code.

Commentaires client.