Fonction EnumSystemLocalesEx (winnls.h)

  • Article

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

Note L’application doit appeler cette fonction de préférence à EnumSystemLocales si elle est conçue pour s’exécuter uniquement sur Windows Vista et versions ultérieures.
 

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.

[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

Voir aussi

EnumLocalesProcEx

EnumSystemLocales

Prise en charge des langues nationales

Fonctions de prise en charge des langues nationales