LoadLibraryShim-Funktion

Aktualisiert: August 2010

Lädt eine angegebene Version einer DLL, die im .NET Framework Redistributable Package enthalten ist.

Diese Funktion ist in .NET Framework, Version 4 veraltet. Verwenden Sie stattdessen die ICLRRuntimeInfo::LoadLibrary-Methode.

HRESULT LoadLibraryShim (
    [in]  LPCWSTR  szDllName,
    [in]  LPCWSTR  szVersion,
          LPVOID   pvReserved,
    [out] HMODULE *phModDll
);

Parameter

• szDllName
  [in] Eine mit 0 (null) endende Zeichenfolge, die den Namen der DLL darstellt, die aus der .NET Framework-Bibliothek geladen werden soll.

• szVersion
  [in] Eine mit 0 (null) endende Zeichenfolge, die die Version der zu ladenden DLL darstellt. Wenn szVersion NULL ist, ist die Version, die zum Laden aktiviert ist, die neueste Version der angegebenen DLL, die kleiner als Version 4 ist. Das bedeutet, dass alle Versionen gleich oder größer Version 4 ignoriert werden, wenn szVersion den Wert NULL aufweist, und wenn keine Version kleiner als Version 4 installiert ist, die DLL nicht geladen werden kann. Damit wird sichergestellt, dass die Installation von .NET Framework 4 nicht bereits vorhandene Anwendungen oder Komponenten beeinträchtigt. Weitere Informationen finden Sie im Eintrag Prozessinterne SxS und Migration - Schnellstart im CLR-Teamblog.

• pvReserved
  Für zukünftige Verwendung reserviert.

• phModDll
  [out] Ein Zeiger auf das Handle des Moduls.

Rückgabewert

Diese Methode gibt COM-Standardfehlercodes (Component Object Model) zurück, die zusätzlich zu den folgenden Werten in WinError.h definiert sind.

Rückgabecode	Beschreibungen
S_OK	Die Methode wurde erfolgreich abgeschlossen.
CLR_E_SHIM_RUNTIMELOAD	Zum Laden von szDllName ist das Laden der Common Language Runtime (CLR) erforderlich, und die erforderliche Version der CLR kann nicht geladen werden.

Hinweise

Diese Funktion wird zum Laden von DLLs verwendet, die im .NET Framework Redistributable Package enthalten sind. Vom Benutzer generierte DLLs werden hiermit nicht geladen.

Hinweis
Ab .NET Framework Version 2.0 bewirkt das Laden von Fusion.dll das Laden der CLR.Dies liegt daran, dass die Funktionen in Fusion.dll jetzt Wrapper sind, deren Implementierungen von der Laufzeit bereitgestellt werden.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: MSCorEE.h

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

Siehe auch

Weitere Ressourcen

Hosten globaler statischer .NET Framework 1.1- und 2.0-Funktionen

Änderungsprotokoll

Datum	Versionsgeschichte	Grund
August 2010	Prozessinternes paralleles Verhalten von .NET Framework 4 wurde beschrieben. Liste von Rückgabewerten wurde hinzugefügt. Eine Alternative für die veraltete Methode wurde hinzugefügt.	Korrektur inhaltlicher Fehler.