ICLRRuntimeHost-Schnittstelle

Stellt Funktionen ähnlich zu denen der in .NET Framework, Version 1, bereitgestellten ICorRuntimeHost-Schnittstelle mit den folgenden Änderungen bereit:

• Hinzufügen der SetHostControl-Methode, um die Schnittstelle des Hoststeuerelements festzulegen.

• Auslassen einiger Methoden, die von ICorRuntimeHost bereitgestellt wurden.

Methoden

Methode	Beschreibungen
ICLRRuntimeHost::ExecuteApplication-Methode	Wird in manifestbasierten -Szenarien der ClickOnce-Bereitstellung zum Angeben der Anwendung verwendet, die in einer neuen Domäne aktiviert werden soll.
ICLRRuntimeHost::ExecuteInAppDomain-Methode	Gibt die AppDomain an, in der der angegebene verwaltete Code ausgeführt werden soll.
ICLRRuntimeHost::ExecuteInDefaultAppDomain-Methode	Ruft die angegebene Methode des angegebenen Typs in der angegebenen Assembly auf.
ICLRRuntimeHost::GetCLRControl-Methode	Ruft einen Schnittstellenzeiger vom Typ ICLRControl ab, den Hosts zum Anpassen von Aspekten der Common Language Runtime (CLR) verwenden können.
ICLRRuntimeHost::GetCurrentAppDomainId-Methode	Ruft den numerischen Bezeichner der aktuell ausgeführten AppDomain ab.
ICLRRuntimeHost::SetHostControl-Methode	Legt die Schnittstelle des Hoststeuerelements fest. Sie müssen SetHostControl vor Start aufrufen.
ICLRRuntimeHost::Start-Methode	Initialisiert die CLR in einem Prozess.
ICLRRuntimeHost::Stop-Methode	Beendet die Ausführung des Codes durch die Laufzeit.
ICLRRuntimeHost::UnloadAppDomain-Methode	Entlädt die AppDomain, die dem angegebenen numerischen Bezeichner entspricht.

Hinweise

Verwenden Sie ab .NET Framework, Version 4 die ICLRMetaHost-Schnittstelle, um einen Zeiger auf die ICLRRuntimeInfo-Schnittstelle zu definieren, und rufen Sie dann die ICLRRuntimeInfo::GetInterface-Methode auf, um einen Zeiger auf ICLRRuntimeHost zu definieren. In früheren Versionen von .NET Framework ruft der Host einen Zeiger auf eine ICLRRuntimeHost-Instanz ab, indem CorBindToRuntimeEx oder CorBindToCurrentRuntime aufgerufen wird. Anstelle von ICorRuntimeHost müssen Sie ICLRRuntimeHost verwenden, um Implementierungen der in .NET Framework, Version 2.0, zur Verfügung stehenden Technologien bereitzustellen.

Wichtig
Die Start-Methode sollte nicht vor dem Aufruf der ExecuteApplication-Methode aufgerufen werden, um eine manifestbasierte Anwendung zu aktivieren.Wenn die Start-Methode zuerst aufgerufen wird, schlägt der ExecuteApplication-Methodenaufruf fehl.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: MSCorEE.h

Bibliothek: als Ressource in MSCorEE.dll enthalten

.NET Framework-Versionen: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Siehe auch

Referenz

CorBindToCurrentRuntime-Funktion

CorBindToRuntimeEx-Funktion

ICLRControl-Schnittstelle

ICorRuntimeHost-Schnittstelle

CLRRuntimeHost-Co-Klasse

Konzepte

Übersicht über Hosting

Weitere Ressourcen

Hostingschnittstellen

Änderungsprotokoll

Datum	Versionsgeschichte	Grund
Juni 2010	Die Anweisungen zum Abrufen eines Zeigers auf die Schnittstelle wurden korrigiert.	Korrektur inhaltlicher Fehler.