LoadLibraryShim-Funktion
Lädt eine angegebene Version einer DLL aus dem weitervertreibbaren .NET Framework-Paket.
Diese Funktion wurde in .NET Framework 4 als veraltet markiert. Verwenden Sie stattdessen die ICLRRuntimeInfo::LoadLibrary-Methode.
Syntax
HRESULT LoadLibraryShim (
[in] LPCWSTR szDllName,
[in] LPCWSTR szVersion,
LPVOID pvReserved,
[out] HMODULE *phModDll
);
Parameter
szDllName
[in] Eine mit null endende Zeichenfolge, die den Namen der DLL darstellt, die aus der .NET Framework-Bibliothek geladen werden soll.
szVersion
[in] Eine mit null endende Zeichenfolge, die die Version der zu ladenden DLL darstellt. Wenn szVersion NULL ist, wird zum Laden die neueste Version der angegebenen DLL ausgewählt, die kleiner als die Version 4 ist. Das bedeutet: Alle Versionen, die mindestens der Version 4 entsprechen, werden ignoriert, wenn szVersion NULL ist. Ist keine Version installiert, die kleiner als die Version 4 ist, kann die DLL nicht geladen werden. Dadurch wird sichergestellt, dass sich die Installation von .NET Framework 4 nicht auf bereits vorhandene Anwendungen oder Komponenten auswirkt. Sehen Sie sich den Eintrag In-Proc SxS and Migration Quick Start (Schnellstart für prozessinterne parallele Runtime und Migration) im CLR-Teamblog an.
pvReserved
Für die zukünftige Verwendung reserviert.
phModDll
[out] Ein Zeiger auf das Handle des Moduls.
Rückgabewert
Diese Methode gibt zusätzlich zu den folgenden Werten COM-Standardfehlercodes (Component Object Model) zurück, die in „WinError.h“ definiert sind.
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Die Methode wurde erfolgreich abgeschlossen. |
| CLR_E_SHIM_RUNTIMELOAD | Zum Laden von szDllName muss die Common Language Runtime (CLR) geladen werden, und die erforderliche CLR-Version kann nicht geladen werden. |
Bemerkungen
Diese Funktion wird verwendet, um DLLs aus dem weitervertreibbaren .NET Framework-Paket zu laden. Benutzergenerierte DLLs werden nicht geladen.
Hinweis
Ab .NET Framework 2.0 führt das Laden von „Fusion.dll“ dazu, dass auch die CLR geladen wird. Dies liegt daran, dass die Funktionen in „Fusion.dll“ jetzt Wrapper sind, deren Implementierungen von der Runtime bereitgestellt werden.
Anforderungen
Plattformen: Informationen finden Sie unter Systemanforderungen.
Header: MSCorEE.h
.NET Framework-Versionen: Seit Version 1.0 verfügbar
