Функция SetConsoleOutputCP
Задает выходную кодовую страницу, используемую консолью, связанной с вызывающим процессом. Консоль использует свою выходную кодовую страницу для перевода значений символов, написанных различными выходными функциями в изображения, отображаемые в окне консоли.
Синтаксис
BOOL WINAPI SetConsoleOutputCP(
_In_ UINT wCodePageID
);
Параметры
wCodePageID [in]
Идентификатор заданной кодовой страницы. Дополнительные сведения см. в подразделе "Примечания".
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Замечания
Кодовая страница сопоставляет 256 кодов символов с отдельными символами. Разные кодовые страницы включают разные специальные символы, как правило, настроенные для языка или группы языков.
Если текущий шрифт является шрифтом Юникода фиксированного поля, SetConsoleOutputCP изменяет сопоставление значений символов в набор глифов шрифта, а не загружает отдельный шрифт при каждом вызове. Это влияет на то, как расширенные символы (значение ASCII больше 127) отображаются в окне консоли. Однако если текущий шрифт является растровым шрифтом, SetConsoleOutputCP не влияет на отображение расширенных символов.
Чтобы найти кодовые страницы, установленные или поддерживаемые операционной системой, используйте функцию EnumSystemCodePages . Идентификаторы кодовых страниц, доступных на локальном компьютере, также хранятся в реестре в следующем разделе:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage
Однако лучше использовать EnumSystemCodePages для перечисления кодовых страниц, так как реестр может отличаться в разных версиях Windows. Чтобы определить, является ли определенная кодовая страница допустимой, используйте функцию IsValidCodePage . Чтобы получить дополнительные сведения о кодовой странице, включая его имя, используйте функцию GetCPInfoEx . Список доступных идентификаторов кодовой страницы см. в разделе "Идентификаторы кодовой страницы".
Чтобы определить текущую кодовую страницу консоли, используйте функцию GetConsoleOutputCP . Чтобы задать и получить входную кодовую страницу консоли, используйте функции SetConsoleCP и GetConsoleCP.
Requirements
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхний колонтитул | ConsoleApi2.h (через WinCon.h, включая Windows.h) |
| Библиотека | Kernel32.lib |
| DLL-библиотеки | Kernel32.dll |