Delen via


LoadLibraryShim, functie

Laadt een opgegeven versie van een DLL die is opgenomen in het herdistribueerbare pakket .NET Framework.

Deze functie is afgeschaft in de .NET Framework 4. Gebruik in plaats daarvan de methode ICLRRuntimeInfo::LoadLibrary .

Syntaxis

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

Parameters

szDllName
[in] Een tekenreeks met einde nul die de naam vertegenwoordigt van de DLL die moet worden geladen vanuit de .NET Framework-bibliotheek.

szVersion
[in] Een tekenreeks met nuleinden die de versie van het DLL-bestand vertegenwoordigt dat moet worden geladen. Als szVersion null is, is de geselecteerde versie voor het laden de nieuwste versie van de opgegeven DLL die kleiner is dan versie 4. Dat wil gezegd dat alle versies die gelijk zijn aan of groter zijn dan versie 4, worden genegeerd als szVersion null is en als er geen versie kleiner dan versie 4 is geïnstalleerd, kan de DLL niet worden geladen. Dit is om ervoor te zorgen dat de installatie van de .NET Framework 4 geen invloed heeft op bestaande toepassingen of onderdelen. Zie de vermelding In-Proc SxS and Migration Quick Start in de CLR-teamblog.

pvReserved
Gereserveerd voor toekomstig gebruik.

phModDll
[uit] Een aanwijzer naar de ingang van de module.

Retourwaarde

Deze methode retourneert standaard COM-foutcodes (Component Object Model), zoals gedefinieerd in WinError.h, naast de volgende waarden.

Retourcode Beschrijving
S_OK De methode is voltooid.
CLR_E_SHIM_RUNTIMELOAD Voor het laden szDllName moet de COMMON Language Runtime (CLR) worden geladen en de benodigde versie van de CLR kan niet worden geladen.

Opmerkingen

Deze functie wordt gebruikt voor het laden van DLL's die zijn opgenomen in het herdistribueerbare pakket .NET Framework. Er worden geen door de gebruiker gegenereerde DLL's geladen.

Notitie

Vanaf .NET Framework versie 2.0 zorgt het laden van Fusion.dll ervoor dat de CLR wordt geladen. Dit komt doordat de functies in Fusion.dll nu wrappers zijn waarvan de implementaties worden geleverd door de runtime.

Vereisten

Platforms: Zie Systeemvereisten.

Header: MSCorEE.h

.NET Framework versies: beschikbaar sinds 1.0

Zie ook