CorBindToRuntimeHost-Funktion
Ermöglicht es Hosts, eine angegebene Version der Common Language Runtime (CLR) in einen Prozess zu laden.
Diese Funktion ist in .NET Framework 4 veraltet.
Syntax
HRESULT CorBindToRuntimeHost (
[in] LPCWSTR pwszVersion,
[in] LPCWSTR pwszBuildFlavor,
[in] LPCWSTR pwszHostConfigFile,
[in] VOID* pReserved,
[in] DWORD startupFlags,
[in] REFCLSID rclsid,
[in] REFIID riid,
[out] LPVOID FAR *ppv
);
Parameter
pwszVersion
[in] Eine Zeichenfolge, welche die Version der zu ladenden CLR beschreibt.
Eine Versionsnummer in .NET Framework besteht aus vier Teilen, die durch Punkte getrennt sind: major.minor.build.revision. Die als pwszVersion
übergebene Zeichenfolge muss mit dem Buchstaben "v" beginnen, auf den die ersten drei Teile der Versionsnummer folgen (z. B. "v1.0.1529").
Einige Versionen der CLR werden mit einer Richtlinienanweisung installiert, welche die Kompatibilität mit früheren Versionen der CLR angibt. In der Standardeinstellung wertet das Startmodul pwszVersion
anhand von Richtlinienanweisungen aus und lädt die neueste Version der Common Language Runtime, die mit der angeforderten Version kompatibel ist. Ein Host kann erzwingen, dass das Startmodul die Richtlinienauswertung überspringt und genau die in pwszVersion
angegebene Version lädt, indem für startupFlags
der Wert STARTUP_LOADER_SAFEMODE übergeben wird.
Wenn pwszVersion
null,
ist, wird keine Version der CLR geladen. Stattdessen wird "CLR_E_SHIM_RUNTIMELOAD" zurückgegeben, womit angegeben wird, dass die Laufzeit nicht geladen werden konnte.
pwszBuildFlavor
[in] Eine Zeichenfolge, die angibt, ob der Serverbuild oder der Arbeitsstationsbuild der CLR geladen werden soll. Gültige Werte sind svr
und wks
. Der Serverbuild wurde so optimiert, dass mehrere Prozessoren zur Ausführung der Garbage Collection genutzt werden können. Der Arbeitsstationsbuild wurde für die Ausführung von Clientanwendungen auf einem Computer mit einem einzelnen Prozessor optimiert.
Wenn pwszBuildFlavor
auf NULL festgelegt wurde, wird automatisch der Arbeitsstationsbuild geladen. Bei der Ausführung auf einem Computer mit einem einzelnen Prozessor wird immer der Arbeitsstationsbuild geladen, selbst wenn pwszBuildFlavor
auf svr
festgelegt wurde. Wenn jedoch pwszBuildFlavor
auf svr
festgelegt ist und die parallele Garbage Collection angegeben wird (siehe Beschreibung des startupFlags
-Parameters weiter unten), wird der Serverbuild geladen.
Hinweis
Die gleichzeitige Garbage Collection wird nicht in Anwendungen unterstützt, die den WOW64 x86-Emulator auf 64-Bit-Systemen mit einer Implementierung der Intel Itanium-Architektur (früher als IA-64 bezeichnet) ausführen. Weitere Informationen zur Verwendung von WOW64 auf 64-Bit-Windows-Systemen finden Sie unter Ausführen von 32-Bit-Anwendungen.
pwszHostConfigFile
[in] Der Name einer Hostkonfigurationsdatei, welche die zu ladende Version der CLR angibt. Wenn der Dateiname keinen vollqualifizierten Pfad enthält, wird angenommen, dass sich die Datei in demselben Verzeichnis befindet wie die ausführbare Datei, die den Aufruf ausgeführt hat.
pReserved
[in] Für zukünftige Erweiterungen reserviert.
startupFlags
[in] Ein Satz von Flags, welche die gleichzeitige Garbage Collection, domänenneutralen Code und das Verhalten des pwszVersion
-Parameters steuern. Wenn kein Flag festgelegt ist, gilt als Standardwert die Einzeldomäne. Eine Liste der unterstützten Werte finden Sie unter STARTUP_FLAGS-Enumeration.
rclsid
[in] Die CLSID
der Co-Klasse, die entweder die ICorRuntimeHost-Schnittstelle oder die ICLRRuntimeHost-Schnittstelle implementiert. Unterstützte Werte sind "CLSID_CorRuntimeHost" oder "CLSID_CLRRuntimeHost".
riid
[in] Die IID
der angeforderten Schnittstelle. Unterstützte Werte sind "IID_ICorRuntimeHost" oder "IID_ICLRRuntimeHost".
ppv
[out] Ein Schnittstellenzeiger auf die Version der Common Language Runtime, die geladen wurde.
Anforderungen
Plattformen: Informationen finden Sie unter Systemanforderungen.
Header: MSCorEE.idl
Bibliothek: MSCorEE.dll
.NET Framework-Versionen: seit Version 1.0 verfügbar