LoadLibraryShim — Funkcja
Ładuje określoną wersję biblioteki DLL uwzględnionej w pakiecie redystrybucyjnym .NET Framework.
Ta funkcja została uznana za przestarzałą w .NET Framework 4. Zamiast tego użyj metody ICLRRuntimeInfo::LoadLibrary .
Składnia
HRESULT LoadLibraryShim (
[in] LPCWSTR szDllName,
[in] LPCWSTR szVersion,
LPVOID pvReserved,
[out] HMODULE *phModDll
);
Parametry
szDllName
[in] Ciąg bez końca, który reprezentuje nazwę biblioteki DLL, która ma zostać załadowana z biblioteki .NET Framework.
szVersion
[in] Ciąg zerowy, który reprezentuje wersję biblioteki DLL do załadowania. Jeśli szVersion ma wartość null, wersja wybrana do załadowania jest najnowszą wersją określonej biblioteki DLL, która jest mniejsza niż wersja 4. Oznacza to, że wszystkie wersje równe lub większe niż wersja 4 są ignorowane, jeśli szVersion ma wartość null, a jeśli nie zainstalowano wersji mniejszej niż wersja 4, nie można załadować biblioteki DLL. Ma to na celu zapewnienie, że instalacja .NET Framework 4 nie ma wpływu na istniejące aplikacje ani składniki. Zobacz wpis In-Proc SxS and Migration Quick Start w blogu zespołu CLR.
pvReserved
Zarezerwowane do użytku w przyszłości.
phModDll
[out] Wskaźnik do uchwytu modułu.
Wartość zwracana
Ta metoda zwraca standardowe kody błędów modelu obiektów składników (COM), zgodnie z definicją w pliku WinError.h, oprócz następujących wartości.
| Kod powrotu | Opis |
|---|---|
| S_OK | Metoda została ukończona pomyślnie. |
| CLR_E_SHIM_RUNTIMELOAD | Ładowanie szDllName wymaga załadowania środowiska uruchomieniowego języka wspólnego (CLR), a nie można załadować niezbędnej wersji środowiska CLR. |
Uwagi
Ta funkcja służy do ładowania bibliotek DLL zawartych w pakiecie redystrybucyjnym .NET Framework. Nie ładuje on bibliotek DLL generowanych przez użytkownika.
Uwaga
Począwszy od .NET Framework w wersji 2.0, ładowanie Fusion.dll powoduje załadowanie środowiska CLR. Wynika to z tego, że funkcje w Fusion.dll są teraz otokami, których implementacje są dostarczane przez środowisko uruchomieniowe.
Wymagania
Platformy: Zobacz Wymagania systemowe.
Nagłówka: MSCorEE.h
wersje .NET Framework: dostępne od wersji 1.0
