LoadLibraryShim, fonction

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

Cette fonction est déconseillée dans le .NET Framework version 4. Utilisez à la place la méthode ICLRRuntimeInfo::GetInterface.

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

Paramètres

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

• szVersion
  [in] Chaîne terminée par zéro représentant la version de la DLL à charger. Si szVersion est null, la version sélectionnée pour charger est la version la plus récente de la DLL spécifiée qui est inférieure à la version 4. Autrement dit, toutes les versions égales ou supérieures à la version 4 sont ignorées si szVersion est null, et si aucune version inférieure à la version 4 n'est pas installée, la DLL ne se charge pas. Il s'agit de garantir que l'installation de .NET Framework 4 n'affecte pas les applications ou composants préexistants. Consultez l'entrée In-Proc SxS and Migration Quick Start dans le blog de l'équipe du CLR.

• pvReserved
  Réservé à un usage futur.

• phModDll
  [out] Pointeur vers le handle du module.

Valeur de retour

Cette méthode retourne des codes d'erreur COM standard tels que définis dans WinError.h en plus des valeurs suivantes.

Code de retour	Description
S_OK	La méthode s'est correctement terminée.
CLR_E_SHIM_RUNTIMELOAD	Le chargement de szDllName requiert le chargement du CLR, et la version requise du CLR ne peut pas être chargée.

Notes

Cette fonction est destinée à charger les DLL incluses dans le package redistribuable .NET Framework. Elle ne charge pas les DLL générées par l'utilisateur.

Remarque
Le démarrage avec .NET Framework version 2.0, en chargeant Fusion.dll provoque le chargement du CLR.Cela tient au fait que les fonctions dans Fusion.dll sont maintenant des wrappers dont les implémentations sont fournies par le runtime.

Configuration requise

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : MSCorEE.h

Versions du .NET Framework : 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0

Voir aussi

Autres ressources

Fonctions statiques globales de l'hébergement .NET Framework 1.1 et 2.0

Historique des modifications

Date	Historique	Motif
Août 2010	Comportement décrit .NET Framework 4 en cours de processus côte à côte. A ajouté une liste de valeurs de retour. A ajouté une alternative pour la méthode déconseillée.	Résolution des bogues de contenu.