Función SetConsoleCP
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 |