LoadMUILibraryA, fonction (muiload.h)
Retourne un handle aux ressources spécifiques à la langue associées à un fichier LN (Language-Neutral).
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 d’affectation de noms sur les systèmes d’exploitation pré-Windows Vista pour nommer les répertoires contenant les fichiers de ressources spécifiques au langage. 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 de 'identificateur de langue format. |
|
Interpréter le nom du dossier contenant les fichiers de ressources spécifiques à la langue à l’aide de nom de langue format. |
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 de l’interface utilisateur sur un système d’exploitation pré-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 de retour
Retourne un handle au fichier de ressources spécifique au langage 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 ressource MUI Win32 de déterminer correctement le fichier de ressources spécifique au langage à charger sur les systèmes d’exploitation pré-Windows Vista. Les applications qui utilisent cette fonction n’ont pas besoin d’être créées sur Windows Vista, mais elles doivent établir un lien statique avec la bibliothèque MUILoad fournie dans le Kit de développement logiciel (SDK) Microsoft Windows pour Windows Vista. Cette fonction nécessite que les fichiers de ressources spécifiques au langage et exécutables soient stockés à l’aide de conventions standard. Consultez de déploiement d’applications pour plus d’informations sur le placement des fichiers.
Les éléments suivants influencent le chargement des 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 binaires satellites doivent être sondés. Si l’application définit ce paramètre sur MUI_LANGUAGE_ID, les fichiers binaires sont détectés dans des dossiers avec des valeurs de chaîne hexadécimales. (Ces valeurs n’incluent pas le 0x de début et sont de 4 caractères de longueur. Par exemple, en-US est représentée
en tant que « 0409 » et en « 0009 ». Si l’application définit le paramètre sur MUI_LANGUAGE_NAME, la fonction utilise le chargement des ressources Windows Vista, qui utilise des sondes de dossier basées sur le 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, dépendante du système d’exploitation, pour localiser le fichier de ressources spécifique au langage approprié. Lorsque l’application définit LangID sur une valeur différente de zéro, le mécanisme de détection recherche uniquement le dossier nommé approprié et son équivalent neutre associé. Pour plus d’informations, consultez gestion du langage 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ée pour n’importe quel 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.
Note
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. 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | muiload.h |
| bibliothèque | Muiload.lib |
| redistribuable | Muiload.lib, inclus dans le Kit de développement logiciel (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. |