LoadLibraryShim – funkce
Načte zadanou verzi knihovny DLL, která je součástí distribuovatelného balíčku rozhraní .NET Framework.
Tato funkce je v rozhraní .NET Framework 4 zastaralá. Místo toho použijte metodu ICLRRuntimeInfo::LoadLibrary .
Syntaxe
HRESULT LoadLibraryShim (
[in] LPCWSTR szDllName,
[in] LPCWSTR szVersion,
LPVOID pvReserved,
[out] HMODULE *phModDll
);
Parametry
szDllName
[v] Řetězec zakončený nulou, který představuje název knihovny DLL, která má být načtena z knihovny rozhraní .NET Framework.
szVersion
[v] Řetězec zakončený nulou, který představuje verzi knihovny DLL, která má být načtena. Pokud szVersion je hodnota null, verze vybraná pro načtení je nejnovější verze zadané knihovny DLL, která je menší než verze 4. To znamená, že všechny verze stejné nebo vyšší než verze 4 jsou ignorovány, pokud szVersion má hodnotu null, a pokud není nainstalována žádná verze menší než verze 4, knihovna DLL se nepodaří načíst. Tím se zajistí, že instalace rozhraní .NET Framework 4 nebude mít vliv na již existující aplikace nebo součásti. Podívejte se na položku In-Proc SxS and Migration Quick Start na blogu týmu CLR.
pvReserved
Vyhrazeno pro budoucí použití.
phModDll
[out] Ukazatel na popisovač modulu.
Návratová hodnota
Tato metoda vrátí kromě následujících hodnot standardní kódy chyb modelu COM (Component Object Model), jak jsou definovány v souboru WinError.h.
| Návratový kód | Description |
|---|---|
| S_OK | Metoda byla úspěšně dokončena. |
| CLR_E_SHIM_RUNTIMELOAD | Načítání szDllName vyžaduje načtení modulu CLR (Common Language Runtime) a nelze načíst potřebnou verzi modulu CLR. |
Poznámky
Tato funkce se používá k načtení knihoven DLL, které jsou součástí distribuovatelného balíčku rozhraní .NET Framework. Nenačítá knihovny DLL generované uživatelem.
Poznámka
Počínaje rozhraním .NET Framework verze 2.0 načítání Fusion.dll způsobí načtení modulu CLR. Je to proto, že funkce v Fusion.dll jsou nyní obálky, jejichž implementace jsou poskytovány modulem runtime.
Požadavky
Platformy: Viz Požadavky na systém.
Záhlaví: MSCorEE.h
Verze rozhraní .NET Framework: K dispozici od verze 1.0
