Sdílet prostřednictvím

LoadLibraryShim – funkce

  • Článek

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

Viz také