Fonction EnumSystemLocalesA (winnls.h)

Article
08/27/2023

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

Note Pour des raisons d’interopérabilité, l’application doit préférer la fonction EnumSystemLocalesEx à EnumSystemLocales , car Microsoft migre vers l’utilisation de noms régionaux au lieu d’identificateurs 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 régionaux à énumérer. Les indicateurs peuvent être utilisés séparément ou combinés à l’aide d’un 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 régionaux pris en charge. Cette valeur ne peut pas être utilisée avec LCID_INSTALLED.
LCID_ALTERNATE_SORTS	Énumérez uniquement les autres identificateurs de paramètres régionaux de tri. 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 retournée

Retourne une valeur différente de zéro en cas de réussite, ou 0 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

La fonction énumère les paramètres régionaux en passant les 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.

Notes

L’en-tête winnls.h définit EnumSystemLocales 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


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

EnumLocalesProc

EnumSystemLocalesEx

Prise en charge des langues nationales

Fonctions de prise en charge des langues nationales

Partager via