Lire en anglais

Partager via


Fonction SetConsoleCP

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

Voir aussi

Pages de code d’une console

Fonctions de console

GetConsoleCP

GetConsoleOutputCP

SetConsoleOutputCP