ICLRMetaHost, interface

  • Article

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

Méthodes

Méthode Description
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 de .NET Framework d’origine d’un 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 est une stratégie d’activation héritée est liée, par exemple, en utilisant l’attribut useLegacyV2RuntimeActivationPolicy dans l’entrée de fichier de configuration <startup>, é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 vers le pointeur de fonction spécifié lorsqu’une version du CLR est chargée pour la première fois, mais pas encore lancée. Cette méthode remplace LockClrVersion

Notes

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 : incluse en tant que ressource dans MsCorEE.dll

Versions de .NET Framework : Disponibles depuis 4

Voir aussi