GetCPInfoExA, fonction (winnls.h)

Article
11/20/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 page de codes pour toute page de codes installée ou disponible, ou l’une des valeurs prédéfinies suivantes. Consultez identificateurs de page de codes pour obtenir une liste d’identificateurs pour ANSI et d’autres pages de codes.

Valeur	Signification
CP_ACP	Utilisez la page de codes Windows ANSI 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é; doit être 0.

[out] lpCPInfoEx

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

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_INVALID_PARAMETER. L’une des valeurs de paramètre n’est 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 paramètres de CPINFOEX indiquent qu’un octet de prospect existe, 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.

Note

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. 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