Fonction EnumSystemLocalesA (winnls.h)

Énumère les paramètres régionaux installés ou pris en charge par un système d’exploitation.

Remarque Pour des raisons d’interopérabilité, l’application doit préférer la fonction EnumSystemLocalesEx à EnumSystemLocales, car Microsoft migre vers l’utilisation de noms de paramètres régionaux au lieu d’identificateurs de paramètres régionaux pour les nouveaux paramètres régionaux. Toute application qui sera exécutée uniquement sur Windows Vista et versions ultérieures doit utiliser EnumSystemLocalesEx.

 

Syntaxe

BOOL EnumSystemLocalesA(
  [in] LOCALE_ENUMPROCA lpLocaleEnumProc,
  [in] DWORD            dwFlags
);

Paramètres

[in] lpLocaleEnumProc

Pointeur vers une fonction de rappel définie par l’application. Pour plus d’informations, consultez EnumLocalesProc .

[in] dwFlags

Indicateurs spécifiant les identificateurs de paramètres régionaux à énumérer. Les indicateurs peuvent être utilisés séparément ou combinés à l’aide d’une OR binaire. Si l’application spécifie 0 pour ce paramètre, la fonction se comporte comme pour LCID_SUPPORTED.

Valeur	Signification
LCID_INSTALLED	Énumérez uniquement les identificateurs de paramètres régionaux installés. Cette valeur ne peut pas être utilisée avec LCID_SUPPORTED.
LCID_SUPPORTED	Énumérez tous les identificateurs de paramètres régionaux pris en charge. Cette valeur ne peut pas être utilisée avec LCID_INSTALLED.
LCID_ALTERNATE_SORTS	Énumérez uniquement les identificateurs de paramètres régionaux de tri de remplacement. Si cette valeur est utilisée avec LCID_INSTALLED ou LCID_SUPPORTED, les paramètres régionaux installés ou pris en charge sont récupérés, ainsi que les autres identificateurs de paramètres régionaux de tri.

Valeur de retour

Retourne une valeur différente de zéro si elle réussit ou 0 sinon. 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 pas se produire normalement et indique généralement une installation incorrecte, un problème de disque ou le même.
• ERROR_INVALID_FLAGS. Les valeurs fournies pour les indicateurs n’étaient pas valides.
• ERROR_INVALID_PARAMETER. L’une des valeurs de paramètre n’est pas valide.

Remarques

La fonction énumère les paramètres régionaux en passant des identificateurs régionaux, un par un, à la fonction de rappel définie par l’application spécifiée. Cela se poursuit jusqu’à ce que tous les identificateurs de paramètres régionaux installés ou pris en charge aient été passés à la fonction de rappel ou que la fonction de rappel retourne FALSE.

Note

L’en-tête winnls.h définit EnumSystemLocales 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	winnls.h (include Windows.h)
bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

EnumLocalesProc

EnumSystemLocalesEx

prise en charge des langues nationales

fonctions de prise en charge des langues nationales