Función SetConsoleCP

  • Artículo

Establece la página de códigos de entrada que se utiliza en la consola asociada al proceso de llamada. Una consola utiliza su página de códigos de entrada para traducir la entrada de teclado al valor de carácter correspondiente.

Sintaxis

BOOL WINAPI SetConsoleCP(
  _In_ UINT wCodePageID
);

Parámetros

wCodePageID [in]
Identificador de la página de códigos que se va a establecer. Para obtener más información, vea la sección Comentarios.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Una página de códigos asigna 256 códigos de caracteres a caracteres individuales. Cada página de código incluye caracteres especiales distintos, que suelen estar personalizados para un idioma o grupo de idiomas.

Para buscar las páginas de códigos instaladas o compatibles con el sistema operativo, use la función EnumSystemCodePages. Los identificadores de las páginas de códigos disponibles en el equipo local también se almacenan en el Registro bajo la clave siguiente:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage

Sin embargo, es mejor usar EnumSystemCodePages para enumerar páginas de códigos porque el registro puede diferir en distintas versiones de Windows.

Para determinar si una página de códigos determinada es válida, use la función IsValidCodePage. Para recuperar más información sobre una página de códigos, incluido su nombre, use la función GetCPInfoEx. Para obtener una lista de identificadores de página de códigos disponibles, consulte Identificadores de página de códigos.

Para determinar la página de códigos de entrada actual de una consola, utilice la función GetConsoleCP. Para establecer y recuperar la página de códigos de salida de una consola, utilice las funciones SetConsoleOutputCP y GetConsoleOutputCP.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado ConsoleApi2.h (a través de WinCon.h, incluido Windows.h)
Biblioteca Kernel32.lib
Archivo DLL Kernel32.dll

Consulte también

Páginas de código de la consola

Funciones de la consola

GetConsoleCP

GetConsoleOutputCP

SetConsoleOutputCP