GetCPInfoExW, fonction (winnls.h)

Article
03/04/2024

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

Syntaxe

BOOL GetCPInfoExW(
  [in]  UINT        CodePage,
  [in]  DWORD       dwFlags,
  [out] LPCPINFOEXW lpCPInfoEx
);

Paramètres

[in] CodePage

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

Valeur	Signification
CP_ACP	Utilisez la page de code ANSI Windows par défaut du système.
CP_MACCP	Utilisez la page de code Macintosh par défaut du système.
CP_OEMCP	Utilisez la page de code OEM par défaut du système.
CP_THREAD_ACP	Utilisez la page de code 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 code.

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 code. 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 l’existence d’un octet de prospect, la fonction de conversion ne gère pas nécessairement différemment les octets de prospect, 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 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