GetCPInfoExA, fonction (winnls.h)

Article
03/06/2024

Récupère des informations sur toute page de codes installée ou disponible valide.

Syntaxe

BOOL GetCPInfoExA(
  [in]  UINT        CodePage,
  [in]  DWORD       dwFlags,
  [out] LPCPINFOEXA lpCPInfoEx
);

Paramètres

[in] CodePage

Identificateur de la page de codes pour laquelle récupérer des informations. L’application peut spécifier l’identificateur de la page de codes pour n’importe quelle page de codes installée ou disponible, ou l’une des valeurs prédéfinies suivantes. Consultez Identificateurs de page de codes pour obtenir la liste des identificateurs pour ANSI et d’autres pages de codes.

Valeur	Signification
CP_ACP	Utilisez la page de codes ANSI Windows par défaut du système.
CP_MACCP	Utilisez la page de codes Macintosh par défaut du système.
CP_OEMCP	Utilisez la page de codes OEM par défaut du système.
CP_THREAD_ACP	Utilisez la page de codes ANSI du thread actuel.

[in] dwFlags

Réservés au; doit être 0.

[out] lpCPInfoEx

Pointeur vers une structure CPINFOEX qui reçoit des informations sur la page de codes.

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_INVALID_PARAMETER. L’une des valeurs de paramètre n’était pas valide.

Remarques

Les informations récupérées dans la structure CPINFOEX ne sont pas toujours utiles pour toutes les pages de codes. Pour déterminer les tailles de mémoire tampon, par exemple, l’application doit appeler MultiByteToWideChar ou WideCharToMultiByte pour demander une taille de mémoire tampon précise. Si les paramètres CPINFOEX indiquent qu’il existe un octet de prospect, la fonction de conversion ne gère pas nécessairement les octets de prospect différemment, par exemple dans le cas d’un octet de piste manquant ou illégal.

Notes

L’en-tête winnls.h définit GetCPInfoEx comme 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. La combinaison 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