Freigeben über


ICLRMetaHost-Schnittstelle

Aktualisiert: September 2010

Stellt Methoden bereit, die eine bestimmte Version der Common Language Runtime (CLR) anhand der Versionsnummer zurückgeben, alle installierten CLRs aufführen, alle in einem angegebenen Prozess geladenen Laufzeiten aufführen, die zum Kompilieren einer Assembly verwendete CLR-Version ermitteln, einen Prozess mit einem ordnungsgemäßen Shutdown der Laufzeit beenden und Legacy-API-Bindungen abfragen.

Methoden

Methode

Beschreibungen

ICLRMetaHost::EnumerateInstalledRuntimes-Methode

Gibt für jede auf einem Computer installierte CLR-Version eine Enumeration mit einem gültigen ICLRRuntimeInfo-Schnittstellenzeiger zurück.

ICLRMetaHost::EnumerateLoadedRuntimes-Methode

Gibt eine Enumeration zurück, die einen gültigen ICLRRuntimeInfo-Schnittstellenzeiger für jede CLR enthält, die in einen angegebenen Prozess geladen ist. Diese Methode ersetzt GetVersionFromProcess.

ICLRMetaHost::ExitProcess-Methode

Versucht, alle geladenen Laufzeiten herunterzufahren, und beendet dann den Prozess. Löst die CorExitProcess-Funktion ab.

ICLRMetaHost::GetRuntime-Methode

Ruft die ICLRRuntimeInfo-Schnittstelle für eine bestimmte CLR-Version ab. Diese Methode ersetzt die mit dem STARTUP_LOADER_SAFEMODE-Flag verwendete CorBindToRuntimeEx-Funktion.

ICLRMetaHost::GetVersionFromFile-Methode

Ruft die ursprüngliche .NET Framework-Kompilierungsversion (in den Metadaten gespeichert) der Assembly ab, wenn ihr Dateipfad angegeben wurde. Diese Methode ersetzt GetFileVersion.

ICLRMetaHost::QueryLegacyV2RuntimeBinding-Methode

Gibt eine Schnittstelle zurück, die eine Laufzeit darstellt, an die die Legacyaktivierungsrichtlinie gebunden wurde, z. B. mit dem useLegacyV2RuntimeActivationPolicy-Attribut des <startup>-Element-Konfigurationsdateieintrags, durch direkte Verwendung der Legacyaktivierungs-APIs oder durch das Aufrufen der ICLRRuntimeInfo::BindAsLegacyV2Runtime-Methode.

ICLRMetaHost::RequestRuntimeLoadedNotification-Methode

Garantiert einen Rückruf zum angegebenen Funktionszeiger, wenn eine CLR-Version zuerst geladen, aber noch nicht gestartet wird. Diese Methode ersetzt LockClrVersion.

Hinweise

Eine Instanz dieser Schnittstelle kann nur abgerufen werden, indem die CLRCreateInstance-Funktion wie folgt aufgerufen wird:

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

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: MetaHost.h

Bibliothek: als Ressource in MSCorEE.dll enthalten

.NET Framework-Versionen: 4

Siehe auch

Weitere Ressourcen

Hostingschnittstellen

Hosting (Referenz zur nicht verwalteten API)

Änderungsprotokoll

Datum

Versionsgeschichte

Grund

September 2010

IID in der Codeauflistung wurde korrigiert.

Kundenfeedback.