Fonction EnumSystemLanguageGroupsA (winnls.h)

  • Article

Énumère les groupes de langues installés sur un système d’exploitation ou pris en charge par celui-ci.

Note Pour les paramètres régionaux personnalisés, votre application doit appeler EnumSystemLocalesEx au lieu de EnumSystemLanguageGroups.

 

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
LGRPID_INSTALLED
 Énumérez uniquement les identificateurs de groupe de langues installés.
LGRPID_SUPPORTED
 É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

Voir aussi

EnumLanguageGroupLocales

EnumLanguageGroupsProc

IsValidLanguageGroup

Prise en charge des langues nationales

Fonctions de prise en charge des langues nationales