ICLRMetaHost-Schnittstelle

Artikel
08/10/2011

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.

September 2010

IID in der Codeauflistung wurde korrigiert.

Kundenfeedback.

Freigeben über