Поделиться через


Функция SetConsoleCP

Задает входную кодовую страницу, используемую консолью, связанной с вызывающим процессом. Консоль использует свою кодовую страницу ввода для перевода ввода клавиатуры в соответствующее значение символа.

Синтаксис

BOOL WINAPI SetConsoleCP(
  _In_ UINT wCodePageID
);

Параметры

wCodePageID [in]
Идентификатор заданной кодовой страницы. Дополнительные сведения см. в подразделе "Примечания".

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Замечания

Кодовая страница сопоставляет 256 кодов символов с отдельными символами. Разные кодовые страницы включают разные специальные символы, как правило, настроенные для языка или группы языков.

Чтобы найти кодовые страницы, установленные или поддерживаемые операционной системой, используйте функцию EnumSystemCodePages . Идентификаторы кодовых страниц, доступных на локальном компьютере, также хранятся в реестре в следующем разделе:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage

Однако лучше использовать EnumSystemCodePages для перечисления кодовых страниц, так как реестр может отличаться в разных версиях Windows.

Чтобы определить, является ли определенная кодовая страница допустимой, используйте функцию IsValidCodePage . Чтобы получить дополнительные сведения о кодовой странице, включая его имя, используйте функцию GetCPInfoEx . Список доступных идентификаторов кодовой страницы см. в разделе "Идентификаторы кодовой страницы".

Чтобы определить текущую кодовую страницу консоли, используйте функцию GetConsoleCP . Чтобы задать и получить выходную кодовую страницу консоли, используйте функции SetConsoleOutputCP и GetConsoleOutputCP.

Requirements

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхний колонтитул ConsoleApi2.h (через WinCon.h, включая Windows.h)
Библиотека Kernel32.lib
DLL-библиотеки Kernel32.dll

См. также

Кодовые страницы консоли

Функции консоли

GetConsoleCP

GetConsoleOutputCP

SetConsoleOutputCP