Partager via

LoadLibraryShim, fonction

  • Article

Charge une version spécifiée d’une DLL incluse dans le package redistribuable .NET Framework.

Cette fonction a été dépréciée dans le .NET Framework 4. Utilisez la méthode ICLRRuntimeInfo::LoadLibrary à la place.

Syntaxe

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

Paramètres

szDllName
[in] Chaîne terminée par zéro qui représente le nom de la DLL à charger à partir de la bibliothèque .NET Framework.

szVersion
[in] Chaîne terminée par zéro qui représente la version de la DLL à charger. Si szVersion a la valeur Null, la version sélectionnée pour le chargement est la dernière version de la DLL spécifiée inférieure à la version 4. Autrement dit, toutes les versions égales ou supérieures à la version 4 sont ignorées si szVersion a la valeur Null et, si aucune version inférieure à la version 4 n’est installée, le chargement de la DLL échoue. Cela permet de s’assurer que l’installation du .NET Framework 4 n’affecte pas les applications ou composants préexistants. Consultez le billet In-Proc SxS and Migration Quick Start du blog de l’équipe CLR.

pvReserved
Réservé pour un usage futur.

phModDll
[out] Pointeur vers le handle du module.

Valeur de retour

Cette méthode retourne des codes d’erreur COM (Component Object Model) standard, comme défini dans WinError.h, en plus des valeurs suivantes.

Code de retour Description
S_OK La commande s'est correctement terminée.
CLR_E_SHIM_RUNTIMELOAD Le chargement de szDllName nécessite le chargement du common language runtime (CLR) et la version nécessaire du CLR ne peut pas être chargée.

Notes

Cette fonction est utilisée pour charger des DLL incluses dans le package redistribuable .NET Framework. Elle ne charge pas les DLL générées par l’utilisateur.

Notes

À compter de .NET Framework version 2.0, le chargement de Fusion.dll entraîne le chargement du CLR. Cela est dû au fait que les fonctions dans Fusion.dll sont désormais des wrappers dont les implémentations sont fournies par le runtime.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MSCorEE.h

Versions de .NET Framework : disponible depuis la version 1.0

Voir aussi