Fonction EnumSystemCodePagesW (winnls.h)
Énumère les pages de codes installées ou prises en charge par un système d’exploitation.
Syntaxe
BOOL EnumSystemCodePagesW(
[in] CODEPAGE_ENUMPROCW 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 codes à énumérer. Ce paramètre peut avoir l’une des valeurs suivantes, qui s’excluent mutuellement.
| Valeur | Signification |
|---|---|
|
Énumérez uniquement les pages de codes installées. |
|
Énumérez toutes les pages de codes prises en charge. |
Valeur de retour
Retourne une valeur différente de zéro si elle réussit ou 0 sinon. 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 pas se produire normalement et indique généralement une installation incorrecte, un problème de disque ou le même.
- ERROR_INVALID_FLAGS. Les valeurs fournies pour les indicateurs n’étaient pas valides.
- ERROR_INVALID_PARAMETER. L’une des valeurs de paramètre n’est pas valide.
Remarques
Cette fonction énumère les pages de codes en passant des identificateurs de page de codes, 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 codes installés ou pris en charge aient été passés à la fonction de rappel, ou que la fonction de rappel retourne FAUX.
Lorsqu’une application utilise cette fonction pour déterminer une page de codes appropriée pour enregistrer des données, elle doit utiliser Unicode si possible. D’autres pages de codes ne sont pas aussi portables que Unicode entre les fournisseurs ou les systèmes d’exploitation, en raison de différentes implémentations des normes associées.
Note
L’en-tête winnls.h définit EnumSystemCodePages en tant qu’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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau | Applications UWP] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau | Applications UWP] |
| plateforme cible | Windows |
| d’en-tête | winnls.h (include Windows.h) |
| bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |