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 通过 WinCon (包含 Windows .h)
Kernel32.lib
DLL Kernel32.dll

另请参阅

控制台代码页

控制台函数

GetConsoleCP

GetConsoleOutputCP

SetConsoleOutputCP