LoadLibraryShim-funktion

Läser in en angiven version av en DLL som ingår i .NET Framework omdistribuerbart paket.

Den här funktionen är inaktuell i .NET Framework 4. Använd ICLRRuntimeInfo::LoadLibrary-metoden i stället.

Syntax

HRESULT LoadLibraryShim (  
    [in]  LPCWSTR  szDllName,  
    [in]  LPCWSTR  szVersion,  
          LPVOID   pvReserved,  
    [out] HMODULE *phModDll  
);  

Parametrar

szDllName
[in] En nollsluten sträng som representerar namnet på DLL:en som ska läsas in från .NET Framework-biblioteket.

szVersion
[in] En nollsluten sträng som representerar den version av DLL-filen som ska läsas in. Om szVersion är null är den version som valts för inläsning den senaste versionen av den angivna DLL-filen som är mindre än version 4. Det innebär att alla versioner som är lika med eller större än version 4 ignoreras om szVersion är null, och om ingen version mindre än version 4 är installerad kan DLL-filen inte läsas in. Detta är för att säkerställa att installationen av .NET Framework 4 inte påverkar befintliga program eller komponenter. Se posten Snabbstart för In-Proc SxS och Migrering i CLR-teamets blogg.

pvReserved
Reserverad för framtida användning.

phModDll
[ut] En pekare till handtaget för modulen.

Returvärde

Den här metoden returnerar COM-felkoder (Standard Component Object Model), enligt definitionen i WinError.h, utöver följande värden.

Returkod	Description
S_OK	Metoden har slutförts.
CLR_E_SHIM_RUNTIMELOAD	Inläsning szDllName kräver inläsning av CLR (Common Language Runtime), och den nödvändiga versionen av CLR kan inte läsas in.

Kommentarer

Den här funktionen används för att läsa in DLL:er som ingår i det .NET Framework omdistribuerbara paketet. Den läser inte in användargenererade DLL:er.

Anteckning

Från och med .NET Framework version 2.0 medför inläsning av Fusion.dll CLR att läsas in. Det beror på att funktionerna i Fusion.dll nu är omslutningar vars implementeringar tillhandahålls av körningen.

Krav

Plattformar: Se Systemkrav.

Huvudet: MSCorEE.h

.NET Framework versioner: Tillgänglig sedan 1.0

Se även

• Inaktuella CLR-värdfunktioner