Fonction EnumSystemLanguageGroupsA (winnls.h)
Énumère les groupes de langues installés sur un système d’exploitation ou pris en charge par celui-ci.
Syntaxe
BOOL EnumSystemLanguageGroupsA(
[in] LANGUAGEGROUP_ENUMPROCA lpLanguageGroupEnumProc,
[in] DWORD dwFlags,
[in] LONG_PTR lParam
);
Paramètres
[in] lpLanguageGroupEnumProc
Pointeur vers une fonction de rappel définie par l’application. Pour plus d’informations, consultez EnumLanguageGroupsProc.
[in] dwFlags
Indicateurs spécifiant les identificateurs de groupe de langues à énumérer. Ce paramètre peut avoir l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Énumérez uniquement les identificateurs de groupe de langues installés. |
|
Énumérez tous les identificateurs de groupe de langues pris en charge. |
[in] lParam
Valeur définie par l’application à passer à la fonction de rappel. Ce paramètre peut être utilisé dans la vérification des erreurs. Il peut également être utilisé pour garantir la sécurité du thread dans la fonction de rappel.
Valeur retournée
Retourne TRUE si elle réussit ou FALSE dans le cas contraire. Pour obtenir des informations d’erreur étendues, l’application peut appeler GetLastError, qui peut retourner l’un des codes d’erreur suivants :
- ERROR_BADDB. La fonction n’a pas pu accéder aux données. Cette situation ne doit normalement pas se produire, et indique généralement une installation incorrecte, un problème de disque ou autre.
- ERROR_INVALID_FLAGS. Les valeurs fournies pour les indicateurs n’étaient pas valides.
- ERROR_INVALID_PARAMETER. L’une des valeurs de paramètre n’était pas valide.
Remarques
Cette fonction énumère les groupes de langues en transmettant les identificateurs de groupe de langue, un par un, à la fonction de rappel définie par l’application spécifiée. Ce processus se poursuit jusqu’à ce que l’identificateur du dernier groupe de langues soit trouvé ou que la fonction de rappel retourne FALSE.
Notes
L’en-tête winnls.h définit EnumSystemLanguageGroups 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 | winnls.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |