LoadLibraryShim függvény
Betölti az .NET-keretrendszer terjeszthető csomagban található DLL megadott verzióját.
Ez a függvény elavult a .NET-keretrendszer 4-ben. Ehelyett használja az ICLRRuntimeInfo::LoadLibrary metódust .
Szintaxis
HRESULT LoadLibraryShim (
[in] LPCWSTR szDllName,
[in] LPCWSTR szVersion,
LPVOID pvReserved,
[out] HMODULE *phModDll
);
Paraméterek
szDllName
[in] Egy nulla végződésű sztring, amely a .NET-keretrendszer kódtárból betöltendő DLL nevét jelöli.
szVersion
[in] Egy nulla végződésű sztring, amely a betöltendő DLL verzióját jelöli. Ha szVersion
null, a betöltéshez kiválasztott verzió a megadott DLL legújabb verziója, amely kisebb a 4-es verziónál. Ez azt jelzi, hogy a rendszer figyelmen kívül hagyja a 4-es vagy annál nagyobb verziót, ha szVersion
null értékű, és ha a 4-es verziónál nem régebbi verzió van telepítve, a DLL nem töltődik be. Ennek az a célja, hogy a .NET-keretrendszer 4 telepítése ne legyen hatással a már meglévő alkalmazásokra vagy összetevőkre. Tekintse meg az In-Proc SxS and Migration Quick Start (In-Proc SxS és migrálás rövid útmutatója ) című bejegyzést a CLR-csapat blogjában.
pvReserved
Jövőbeli használatra fenntartva.
phModDll
[kifelé] A modul fogópontjára mutató mutató.
Visszatérési érték
Ez a metódus a WinError.h fájlban meghatározott standard Component Object Model (COM) hibakódokat adja vissza az alábbi értékek mellett.
Visszatérési kód | Description |
---|---|
S_OK | A metódus sikeresen befejeződött. |
CLR_E_SHIM_RUNTIMELOAD | A betöltéshez szDllName be kell tölteni a közös nyelvi futtatókörnyezetet (CLR), és a CLR szükséges verziója nem tölthető be. |
Megjegyzések
Ez a függvény a .NET-keretrendszer terjeszthető csomagban található DLL-ek betöltésére szolgál. Nem tölti be a felhasználó által létrehozott DLL-eket.
Megjegyzés
A .NET-keretrendszer 2.0-s verziójától kezdve a Fusion.dll betöltése a CLR betöltését eredményezi. Ennek az az oka, hogy a Fusion.dll függvényei mostantól burkolók, amelyek implementációit a futtatókörnyezet biztosítja.
Követelmények
Platformok: Lásd: Rendszerkövetelmények.
Fejléc: MSCorEE.h
.NET-keretrendszer verziók: 1.0 óta elérhető