LoadMUILibraryW, fonction (muiload.h)
Retourne un handle aux ressources spécifiques à la langue associées à un fichier indépendant de la langue (LN) particulier.
Syntaxe
HINSTANCE LoadMUILibraryW(
[in] PCWSTR 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 d’affectation de noms sur les systèmes d’exploitation antérieurs à Windows Vista pour nommer les répertoires contenant les fichiers de ressources propres à la langue. Les indicateurs s’excluent mutuellement et la valeur par défaut est MUI_LANGUAGE_NAME.
| Valeur | Signification |
|---|---|
|
Interpréter le nom du dossier contenant les fichiers de ressources spécifiques à la langue à l’aide du format d’identificateur de langue . |
|
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.
[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 :
- LOCALE_SYSTEM_DEFAULT
- LOCALE_USER_DEFAULT
- LOCALE_CUSTOM_DEFAULT
- LOCALE_CUSTOM_UI_DEFAULT
- LOCALE_CUSTOM_UNSPECIFIED
Valeur retournée
Retourne un handle au fichier de ressources approprié spécifique à la langue 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 spécifiquement d’être généré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 passé dans le paramètre LangID
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 sont de 4 caractères. Par exemple, en-US est représenté
as « 0409 » et en as « 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 la détection 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 au langage approprié. Lorsque l’application définit LangID sur une valeur différente de zéro, le mécanisme de sondage recherche uniquement le dossier nommé approprié et son équivalent neutre associé. Pour plus d’informations, consultez Gestion des langues de l’interface utilisateur.
LoadMUILibrary repose 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 Notes de LoadLibraryEx et FreeLibrary.
Notes
L’en-tête muiload.h définit LoadMUILibrary comme 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. La combinaison 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. |