Fonction EnumSystemLocalesEx (winnls.h)
Énumère les paramètres régionaux installés sur ou pris en charge par un système d’exploitation.
Syntaxe
BOOL EnumSystemLocalesEx(
[in] LOCALE_ENUMPROCEX lpLocaleEnumProcEx,
[in] DWORD dwFlags,
[in] LPARAM lParam,
[in, optional] LPVOID lpReserved
);
Paramètres
[in] lpLocaleEnumProcEx
Pointeur vers une fonction de rappel définie par l’application. La fonction EnumSystemLocalesEx énumère les paramètres régionaux en effectuant des appels répétés à cette fonction de rappel. Pour plus d’informations, consultez EnumLocalesProcEx.
[in] dwFlags
Indicateurs identifiant les paramètres 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 LOCALE_ALL.
- LOCALE_ALL
- LOCALE_ALTERNATE_SORTS ; voir Remarques
- LOCALE_NEUTRALDATA
- LOCALE_SUPPLEMENTAL
- LOCALE_WINDOWS
[in] lParam
Paramètre fourni par l’application à passer à la fonction de rappel. Cela est particulièrement utile pour les applications multithread.
[in, optional] lpReserved
Réservés au; doit être NULL.
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 autres.
- 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 paramètres régionaux en passant les noms de paramètres régionaux, un par un, à la fonction de rappel définie par l’application spécifiée par lpLocaleEnumProcEx. L’énumération continue jusqu’à ce que tous les noms installés ou pris en charge aient été passés à la fonction de rappel ou que la fonction de rappel retourne FALSE.
Les choix pour le paramètre dwFlags sont différents de ceux pour EnumSystemLocales, qui doit faire la distinction entre les paramètres régionaux installés et pris en charge.
Si dwFlags spécifie LOCALE_ALTERNATE_SORTS, la fonction de rappel est appelée pour chaque paramètre régional qui représente un autre ordre de tri. Par exemple, l’espagnol (Espagne) est défini par défaut sur l’ordre de tri international, mais l’ordre de tri traditionnel est disponible pour un autre tri. L’allemand (Allemagne) est défini par défaut sur l’ordre de tri du dictionnaire, mais il existe un autre ordre de tri de carnet de téléphone disponible.
Exemples
Vous trouverez un exemple montrant l’utilisation de cette fonction dans NLS : Exemple d’API basées sur un nom.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | winnls.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |