Fonction EnumSystemCodePagesA (winnls.h)

  • Article

Énumère les pages de code installées ou prises en charge par un système d’exploitation.

Syntaxe

BOOL EnumSystemCodePagesA(
  [in] CODEPAGE_ENUMPROCA lpCodePageEnumProc,
  [in] DWORD              dwFlags
);

Paramètres

[in] lpCodePageEnumProc

Pointeur vers une fonction de rappel définie par l’application. La fonction EnumSystemCodePages énumère les pages de code en effectuant des appels répétés à cette fonction de rappel. Pour plus d’informations, consultez EnumCodePagesProc.

[in] dwFlags

Indicateur spécifiant les pages de code à énumérer. Ce paramètre peut avoir l’une des valeurs suivantes, qui s’excluent mutuellement.

Valeur Signification
CP_INSTALLED
 Énumérez uniquement les pages de code installées.
CP_SUPPORTED
 Énumérez toutes les pages de code prises en charge.

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

Cette fonction énumère les pages de code en transmettant les identificateurs de page de code, un par un, à la fonction de rappel définie par l’application spécifiée. Ce processus se poursuit jusqu’à ce que tous les identificateurs de page de code installés ou pris en charge aient été passés à la fonction de rappel, ou que la fonction de rappel retourne FALSE.

Lorsqu’une application utilise cette fonction pour déterminer une page de code appropriée pour enregistrer des données, elle doit utiliser Unicode dans la mesure du possible. Les autres pages de code ne sont pas aussi portables qu’Unicode entre fournisseurs ou systèmes d’exploitation, en raison d’implémentations différentes des normes associées.

Notes

L’en-tête winnls.h définit EnumSystemCodePages 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 | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [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

EnumCodePagesProc

Prise en charge des langues nationales

Fonctions de prise en charge des langues nationales