getKeyboardLayoutNameA 函数 (winuser.h)

项目
07/21/2023

检索活动输入区域设置标识符的名称， (以前称为调用线程的键盘布局) 。

语法

BOOL GetKeyboardLayoutNameA(
  [out] LPSTR pwszKLID
);

参数

[out] pwszKLID

类型： LPTSTR

缓冲区 (至少 KL_NAMELENGTH 个字符的长度) ，用于接收输入区域设置标识符的名称，包括终止 null 字符。除非进行了布局替换，否则这是提供给 LoadKeyboardLayout 函数的字符串的副本。

有关 Windows 提供的输入布局的列表，请参阅 Windows 的键盘标识符和输入法编辑器。

返回值

类型： BOOL

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

注解

输入区域设置标识符是比键盘布局更广泛的概念，因为它还可以包含语音转文本转换器、输入法编辑器 (IME) 或任何其他形式的输入。

从 Windows 8 开始： 检索与当前键盘布局或输入法关联的语言的首选方法是调用 Windows.Globalization.Language.CurrentInputMethodLanguageTag。如果你的应用将语言标记从 CurrentInputMethodLanguageTag 传递给任何国家语言支持函数，它必须首先通过调用 ResolveLocaleName 来转换标记。

注意

winuser.h 标头将 GetKeyboardLayoutName 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll