Fonction LoadMUILibraryA (muiload.h)

Article
02/29/2024

Retourne un handle aux ressources spécifiques à la langue associées à un fichier LN (Language-Neutral).

Note Pour vous assurer que la DLL est déchargée correctement, vos applications doivent faire correspondre chaque appel à LoadMUILibrary avec un appel correspondant à FreeMUILibrary.

Syntaxe

HINSTANCE LoadMUILibraryA(
  [in] PCSTR  pszFullModuleName,
  [in] DWORD  dwLangConvention,
  [in] LANGID LangID
);

Paramètres

[in] pszFullModuleName

Pointeur vers une chaîne terminée par null spécifiant le nom d’un fichier LN.

[in] dwLangConvention

Indicateurs spécifiant la convention de nommage sur les systèmes d’exploitation antérieurs à Windows Vista pour nommer les répertoires contenant les fichiers de ressources spécifiques à la langue. Les indicateurs s’excluent mutuellement et la valeur par défaut est MUI_LANGUAGE_NAME.

Valeur	Signification
MUI_LANGUAGE_ID	Interpréter le nom du dossier contenant les fichiers de ressources spécifiques à la langue à l’aide du format d’identificateur de langue .
MUI_LANGUAGE_NAME	Interpréter le nom du dossier contenant les fichiers de ressources spécifiques à la langue à l’aide du format de nom de langue .

L’indicateur suivant est disponible en tant qu’option et peut être utilisé en combinaison avec l’un des autres indicateurs.

Valeur	Signification
MUI_LANGUAGE_EXACT	Si des ressources pour la langue identifiée sont introuvables dans les fichiers de ressources, case activée le module main spécifié par pwszModuleName et retourne un handle à ce module si elle réussit.

[in] LangID

Identificateur de langue pour les ressources d’interface utilisateur sur un système d’exploitation antérieur à Windows Vista. L’identificateur de langue ne peut pas correspondre à la langue associée à l’une de ces constantes d’informations de paramètres régionaux :

Valeur retournée

Retourne un handle au fichier de ressources propre à la langue approprié en cas de réussite.

Cette fonction retourne NULL en cas d’échec. Pour obtenir des informations d’erreur étendues, l’application peut appeler GetLastError.

Remarques

Cette fonction permet aux applications développées à l’aide de la technologie de ressources WIN32 MUI de déterminer correctement le fichier de ressources spécifique au langage à charger sur les systèmes d’exploitation antérieurs à Windows Vista. Les applications utilisant cette fonction n’ont pas besoin d’être spécifiquement basées sur Windows Vista, mais elles doivent être liées de manière statique à la bibliothèque MUILoad fournie dans le Microsoft Windows SDK pour Windows Vista. Cette fonction nécessite que les fichiers de ressources exécutables et spécifiques au langage soient stockés à l’aide de conventions standard. Pour plus d’informations sur le placement des fichiers, consultez Déploiement d’applications.

Les éléments suivants influencent le chargement des fichiers binaires satellites par cette fonction.

Version du système d’exploitation exécutant l’application qui appelle la fonction
Indicateur passé dans le paramètre dwLangConvention
État de l’identificateur de langue transmis dans le paramètre LangID

Lors de l’exécution sur Windows Vista, cette fonction charge le module main sans redirection. Seul le paramètre pszFullModuleName est utilisé, car les fonctions du chargeur de ressources effectuent la redirection de manière appropriée lorsqu’elles sont appelées. Lors de l’exécution sur des systèmes d’exploitation antérieurs à Windows Vista, cette fonction prend en compte tous les paramètres que l’application fournit. Il redirige le chargement binaire vers la paire binaire satellite appropriée associée au fichier représenté par pszFullModuleName. Ce processus reconstitue le chemin d’accès associé au fichier pour imiter le comportement de Windows Vista qui sous-tend les fonctions du chargeur de ressources.

L’application utilise le paramètre dwLangConvention pour spécifier la façon dont les fichiers binaires satellites doivent être sondés. Si l’application définit ce paramètre sur MUI_LANGUAGE_ID, les fichiers binaires sont sondés dans des dossiers avec des valeurs de chaîne hexadécimale. (Ces valeurs n’incluent pas le 0x de début et contiennent 4 caractères. Par exemple, en-US est représenté

en tant que « 0409 » et en comme « 0009 ». Si l’application définit le paramètre sur MUI_LANGUAGE_NAME, la fonction utilise le chargement de ressources Windows Vista, qui utilise des sondes de dossier basées sur un nom de langue pour rechercher un fichier satellite.

L’état de l’identificateur de langue dans le paramètre LangID affecte l’analyse des ressources. Si l’application définit ce paramètre sur 0, la fonction utilise la logique de secours prédéfinie, en fonction du système d’exploitation, pour localiser le fichier de ressources propre à la langue approprié. Lorsque l’application définit LangID sur une valeur différente de zéro, le mécanisme d’interrogation recherche uniquement le dossier nommé approprié et son équivalent neutre associé. Pour plus d’informations, consultez Gestion des langues de l’interface utilisateur.

LoadMUILibrary est basé sur la fonction LoadLibraryEx et des considérations similaires doivent être appliquées à son utilisation. En particulier, FreeMUILibrary doit être appelé pour tout handle retourné par LoadMUILibrary. En outre, LoadMUILibrary ne doit pas être appelé à partir de DllMain. Pour plus d’informations, consultez les sections Remarques de LoadLibraryEx et FreeLibrary.

Notes

L’en-tête muiload.h définit LoadMUILibrary comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	muiload.h
Bibliothèque	Muiload.lib
Composant redistribuable	Muiload.lib, inclus dans le SDK Windows pour Windows 7 qui peut être exécuté sur Windows 2000 Professionnel, Windows 2000 Server, Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008 et Windows 7.

Voir aussi

FreeMUILibrary

Interface utilisateur multilingue

Fonctions d’interface utilisateur multilingues

Partager via