Freigeben über

ICLRMetaHost-Schnittstelle

  • Artikel

Stellt Methoden bereit, die eine bestimmte Version der Common Language Runtime (CLR) basierend auf ihrer Versionsnummer zurückgeben, alle installierten CLRs auflisten, alle Runtimes auflisten, die in einem angegebenen Prozess geladen werden, die CLR-Version ermitteln, die zum Kompilieren einer Assembly verwendet wird, einen Prozess mit einem sauberen Herunterfahren der Runtime beenden und Legacy-API-Bindungen abfragen.

Methoden

Methode BESCHREIBUNG
EnumerateInstalledRuntimes-Methode Gibt eine Enumeration zurück, die einen gültigen ICLRRuntimeInfo-Schnittstellenzeiger für jede CLR-Version enthält, die auf einem Computer installiert ist.
EnumerateLoadedRuntimes-Methode Gibt eine Enumeration zurück, die einen gültigen ICLRRuntimeInfo-Schnittstellenzeiger für jede CLR-Version enthält, die in einem bestimmten Prozess geladen. Diese Methode ersetzt GetVersionFromProcess.
ExitProcess-Methode Versucht, alle geladenen Runtimes ordnungsgemäß herunterzufahren, und beendet dann den Prozess. Ersetzt die CorExitProcess-Funktion.
GetRuntime-Methode Ruft die ICLRRuntimeInfo-Schnittstelle ab, die einer bestimmten CLR-Version entspricht. Diese Methode ersetzt die Funktion CorBindToRuntimeEx, die mit dem Flag STARTUP_LOADER_SAFEMODE verwendet wird.
GetVersionFromFile-Methode Ruft die ursprüngliche .NET Framework-Kompilierungsversion der Assembly (gespeichert in den Metadaten) anhand des Dateipfads ab. Diese Methode ersetzt GetFileVersion.
QueryLegacyV2RuntimeBinding-Methode Gibt eine Schnittstelle zurück, die eine Runtime darstellt, an die eine ältere Aktivierungsrichtlinie gebunden wurde, z. B. mithilfe des Konfigurationsdateieintrags für das useLegacyV2RuntimeActivationPolicy-Attribut im <startup>-Element, durch direkte Verwendung der Legacyaktivierungs-APIs oder durch Aufrufen der ICLRRuntimeInfo::BindAsLegacyV2Runtime-Methode.
RequestRuntimeLoadedNotification-Methode Garantiert einen Rückruf des angegebenen Funktionszeigers, wenn eine CLR-Version zum ersten Mal geladen, aber noch nicht gestartet wurde. Diese Methode ersetzt LockClrVersion

Bemerkungen

Die einzige Möglichkeit, eine Instanz dieser Schnittstelle abzurufen, besteht darin, die CLRCreateInstance-Funktion wie folgt aufzurufen:

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

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MetaHost.h

Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.

.NET Framework-Versionen: seit Version 4 verfügbar

Siehe auch