Freigeben über

ICLRMetaHost-Schnittstelle

Stellt Methoden bereit, die eine bestimmte Version der Common Language Runtime (CLR) basierend auf ihrer Versionsnummer zurückgeben, alle installierten CLRs auflisten, alle Laufzeiten auflisten, die in einem angegebenen Prozess geladen werden, ermitteln, die CLR-Version zum Kompilieren einer Assembly, Beenden eines Prozesses mit einem sauberen Herunterfahren der Laufzeit und Abfragen legacy API-Bindung.

Methodik

Methode Description
EnumerateInstalledRuntimes-Methode Gibt eine Aufzählung 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 Aufzählung zurück, die einen gültigen ICLRRuntimeInfo-Schnittstellenzeiger für jeden CLR enthält, der in einem bestimmten Prozess geladen wird. Diese Methode ersetzt GetVersionFromProcess.
ExitProcess-Methode Versucht, alle geladenen Laufzeiten 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 CorBindToRuntimeEx-Funktion , die mit dem STARTUP_LOADER_SAFEMODE Flag 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 Laufzeit darstellt, an die die Legacyaktivierungsrichtlinie gebunden wurde, z. B. mithilfe des useLegacyV2RuntimeActivationPolicy Attributs für den <startup> Elementkonfigurationsdateieintrag, durch direkte Verwendung der Legacyaktivierungs-APIs oder durch Aufrufen der ICLRRuntimeInfo::BindAsLegacyV2Runtime-Methode.
RequestRuntimeLoadedNotification-Methode Garantiert einen Rückruf an den angegebenen Funktionszeiger, wenn eine CLR-Version zuerst geladen, aber noch nicht gestartet wird. Diese Methode ersetzt LockClrVersion

Bemerkungen

Die einzige Möglichkeit zum Abrufen einer Instanz dieser Schnittstelle 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.

Kopfball: MetaHost.h

Bibliothek: In MSCorEE.dll als Ressource enthalten

.NET Framework-Versionen: Verfügbar seit 4

Siehe auch

  • Last updated on