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 函数。 要设置和检索控制台的输出代码页,请使用 SetConsoleOutputCPGetConsoleOutputCP 函数。

要求

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

另请参阅

控制台代码页

控制台函数

GetConsoleCP

GetConsoleOutputCP

SetConsoleOutputCP