Partager via

ICLRMetaHost, interface

Fournit des méthodes qui retournent une version spécifique du Common Language Runtime (CLR) en fonction de son numéro de version, répertorient tous les CLR installés, répertorient tous les runtimes chargés dans un processus spécifié, découvrent la version CLR utilisée pour compiler un assembly, quitter un processus avec un arrêt du runtime propre et interroger la liaison d’API héritée.

Méthodes

Méthode Descriptif
EnumerateInstalledRuntimes, méthode Retourne une énumération qui contient un pointeur d’interface ICLRRuntimeInfo valide pour chaque version clR installée sur un ordinateur.
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.
ExitProcess, méthode Tente d’arrêter correctement tous les runtimes chargés, puis met fin au processus. Remplace la fonction CorExitProcess .
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 .
GetVersionFromFile, méthode Obtient la version de compilation .NET Framework d’origine de l’assembly (stockée dans les métadonnées), en fonction de son chemin d’accès au fichier. Cette méthode remplace GetFileVersion.
QueryLegacyV2RuntimeBinding, méthode Retourne une interface qui représente un runtime auquel la stratégie d’activation héritée a été liée, par exemple en utilisant l’attribut useLegacyV2RuntimeActivationPolicy sur l’entrée <startup> de fichier de configuration d’élément, en utilisant directement les API d’activation héritées ou en appelant la méthode ICLRRuntimeInfo ::BindAsLegacyV2Runtime.
RequestRuntimeLoadedNotification, méthode Garantit un rappel au pointeur de fonction spécifié lorsqu’une version CLR est chargée pour la première fois, mais pas encore démarrée. Cette méthode remplace LockClrVersion

Remarques

La seule façon d’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.

En-tête: MetaHost.h

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

Versions du .NET Framework : Disponible depuis 4

Voir aussi

  • Last updated on