Fonction EnumSystemCodePagesA (winnls.h)
É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 |
|---|---|
|
Énumérez uniquement les pages de code installées. |
|
É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 |