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 函数。


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	ConsoleApi2.h (via WinCon.h, include Windows.h)
库	Kernel32.lib
DLL	Kernel32.dll