Fonction SetConsoleCP

Article
12/22/2023

Définit la page de codes d’entrée utilisée par la console associée au processus appelant. Une console utilise sa page de codes d’entrée pour traduire l’entrée de clavier en valeur de caractère correspondante.

Syntaxe

BOOL WINAPI SetConsoleCP(
  _In_ UINT wCodePageID
);

Paramètres

wCodePageID [entrée]
L’identifiant de la page de codes à définir. Pour plus d'informations, consultez la section Notes.

Valeur renvoyée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

Une page de codes mappe 256 codes de caractères à des caractères individuels. Les différentes pages de code incluent des caractères spéciaux différents, généralement personnalisés pour une langue ou un groupe de langues.

Pour rechercher les pages de codes installées ou prises en charge par le système d’exploitation, utilisez la fonction EnumSystemCodePages. Les identificateurs des pages de codes disponibles sur l’ordinateur local sont également stockés dans le registre sous la clé suivante :

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage

Toutefois, il est préférable d’utiliser la fonction EnumSystemCodePages pour énumérer les pages de codes, car le registre peut différer dans différentes versions de Windows.

Pour déterminer si une page de codes particulière est valide, utilisez la fonction IsValidCodePage. Pour récupérer plus d’informations sur une page de codes, y compris son nom, utilisez la fonction GetCPInfoEx. Pour obtenir la liste des identificateurs de page de codes disponibles, consultez la section Identificateurs de page de codes.

Pour déterminer la page de codes d'entrée actuelle d'une console, utilisez la fonction GetConsoleCP. Pour définir et récupérer la page de codes de sortie d'une console, utilisez les fonctions SetConsoleOutputCP et GetConsoleOutputCP.

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	ConsoleApi2.h (via WinCon.h, include Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll