ICLRMetaHost, interfaceICLRMetaHost 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 installés, listent de tous les runtimes chargés dans un processus spécifié, découvrir la version CLR utilisée pour compiler un assembly, de quitter un processus avec un arrêt de runtime normal et une liaison héritée de l’API de requête.Provides methods that return a specific version of the common language runtime (CLR) based on its version number, list all installed CLRs, list all runtimes that are loaded in a specified process, discover the CLR version used to compile an assembly, exit a process with a clean runtime shutdown, and query legacy API binding.

MéthodesMethods

MéthodeMethod DescriptionDescription
EnumerateInstalledRuntimes, méthodeEnumerateInstalledRuntimes Method Retourne une énumération qui contient un élément valide ICLRRuntimeInfo pointeur d’interface pour chaque version du CLR qui est installée sur un ordinateur.Returns an enumeration that contains a valid ICLRRuntimeInfo interface pointer for each CLR version that is installed on a computer.
EnumerateLoadedRuntimes, méthodeEnumerateLoadedRuntimes Method Retourne une énumération qui contient un élément valide ICLRRuntimeInfo pointeur d’interface pour chaque CLR qui est chargé dans un processus donné.Returns an enumeration that contains a valid ICLRRuntimeInfo interface pointer for each CLR that is loaded in a given process. Cette méthode remplace GetVersionFromProcess.This method supersedes GetVersionFromProcess.
ExitProcess, méthodeExitProcess Method Tente d’arrêter correctement les runtimes tous chargés et puis met fin au processus.Attempts to shut down all loaded runtimes gracefully and then terminates the process. Remplace le CorExitProcess (fonction).Supersedes the CorExitProcess function.
GetRuntime, méthodeGetRuntime Method Obtient le ICLRRuntimeInfo interface qui correspond à une version particulière du CLR.Gets the ICLRRuntimeInfo interface that corresponds to a particular CLR version. Cette méthode remplace la CorBindToRuntimeEx fonction utilisée avec le STARTUP_LOADER_SAFEMODE indicateur.This method supersedes the CorBindToRuntimeEx function used with the STARTUP_LOADER_SAFEMODE flag.
GetVersionFromFile, méthodeGetVersionFromFile Method Obtient d’origine compilation version du .NET Framework l’assembly (stockée dans les métadonnées), son chemin d’accès donnée.Gets the assembly's original .NET Framework compilation version (stored in the metadata), given its file path. Cette méthode remplace GetFileVersion.This method supersedes GetFileVersion.
QueryLegacyV2RuntimeBinding, méthodeQueryLegacyV2RuntimeBinding Method Retourne une interface qui représente un runtime auquel stratégie d’activation héritée a été liée, par exemple à l’aide de la useLegacyV2RuntimeActivationPolicy d’attribut sur le <démarrage > élément entrée de fichier de configuration, en utilisant directement des API d’activation hérité ou en appelant le ICLRRuntimeInfo::BindAsLegacyV2Runtime (méthode).Returns an interface that represents a runtime to which legacy activation policy has been bound, for example by using the useLegacyV2RuntimeActivationPolicy attribute on the <startup> Element configuration file entry, by direct use of the legacy activation APIs, or by calling the ICLRRuntimeInfo::BindAsLegacyV2Runtime method.
RequestRuntimeLoadedNotification, méthodeRequestRuntimeLoadedNotification Method Garantit un rappel pour le pointeur de fonction spécifié lorsqu’une version du CLR est chargée en premier, mais pas encore démarrée.Guarantees a callback to the specified function pointer when a CLR version is first loaded, but not yet started. Cette méthode remplace LockClrVersionThis method supersedes LockClrVersion

NotesRemarks

La seule façon d’obtenir une instance de cette interface est en appelant le CLRCreateInstance fonctionnent comme suit :The only way to get an instance of this interface is by calling the CLRCreateInstance function as follows:

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

Configuration requiseRequirements

Plateformes : Consultez Configuration requise.Platforms: See System Requirements.

En-tête : MetaHost.hHeader: MetaHost.h

Bibliothèque : Inclus en tant que ressource dans MSCorEE.dllLibrary: Included as a resource in MSCorEE.dll

Versions du .NET Framework : Disponible à partir de 4Available since 4.NET Framework Versions: Disponible à partir de 4Available since 4

Voir aussiSee also