CorBindToRuntimeHost-Funktion

Artikel
09/02/2008

Aktualisiert: November 2007

Ermöglicht es Hosts, eine angegebene Version der Common Language Runtime (CLR) in einen Prozess zu laden.

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, die die Version der zu ladenden CLR beschreibt.

Eine Versionsnummer in .NET Framework besteht aus vier von Punkten getrennten Teilen: 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, die die Kompatibilität mit früheren Versionen der CLR angibt. Das Startmodul wertet in der Standardeinstellung 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 der Aufrufer den Wert NULL für pwszVersion angibt, wird die neueste Version der CLR geladen. Beim Übergeben von NULL kann der Host nicht steuern, welche Version der Common Language Runtime geladen wird. Auch wenn dieser Ansatz in einigen Szenarien angemessen sein kann, wird das Angeben einer bestimmten zu ladenden Version durch den Host dringend empfohlen.
pwszBuildFlavor
[in] Eine Zeichenfolge, die angibt, ob das Serverbuild oder das 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 pwszBuildFlavorauf NULL festgelegt wurde, wird automatisch das Arbeitsstationsbuild geladen. Bei der Ausführung auf einem Computer mit einem einzelnen Prozessor wird immer das Arbeitsstationsbuild geladen, selbst wenn pwszBuildFlavorauf svr festgelegt wurde. Wenn aber pwszBuildFlavorauf svr festgelegt ist und die gleichzeitige Garbage Collection angegeben wird (siehe Beschreibung des startupFlags-Parameters weiter unten), wird das Serverbuild geladen.

Tipp

Die gleichzeitige Garbage Collection wird nicht für Anwendungen unterstützt, die im WOW64 x86-Emulator auf 64-Bit-Systemen mit einer Implementierung der Intel Itanium-Architektur (früher als IA-64 bezeichnet) ausgeführt werden. 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, die 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] Reserviert für zukünftige Erweiterbarkeit.
startupFlags
[in] Ein Satz von Flags, die die gleichzeitige Garbage Collection, domänenneutralen Code und das Verhalten des pwszVersion-Parameters steuern. Der Standard ist einzelne Domäne, wenn kein Flag festgelegt wird. Die folgenden Werte werden unterstützt:
- STARTUP_CONCURRENT_GC: Gibt an, dass die gleichzeitige Garbage Collection verwendet werden soll. Wenn der Aufrufer das Serverbuild und die gleichzeitige Garbage Collection auf einem Computer mit einem einzelnen Prozessor anfordert, werden stattdessen das Arbeitsstationsbuild und die nicht gleichzeitige Garbage Collection ausgeführt.
- STARTUP_LOADER_OPTIMIZATION_SINGLE_DOMAIN: Gibt an, dass keine Assemblys als domänenneutral geladen werden.
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN: Gibt an, dass alle Assemblys als domänenneutral geladen werden.
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN_HOST: Gibt an, dass alle Assemblys mit starken Namen als domänenneutral geladen werden.
- STARTUP_LOADER_SAFEMODE: Gibt an, dass die genaue Version der CLR geladen wird, die in pwszVersion übergeben wird. Das Startmodul wertet keine Richtlinien aus, um die neueste kompatible Version zu ermitteln.
rclsid
[in] Die CLSID der Co-Klasse, die die gesuchte Schnittstelle implementiert. Unterstützte Werte sind CLSID_CorRuntimeHost oder NULL.
riid
[in] Die IID der angeforderten Schnittstelle. Die unterstützten Werte der ersten Version der Common Language Runtime sind IID_ICorRuntimeHost oder NULL.
ppv
[out] Ein Schnittstellenzeiger auf die Version der Common Language Runtime, die geladen wurde.