GetKeyboardLayoutNameA 函数 (winuser.h)
检索调用线程的活动输入区域设置标识符(以前称为键盘布局)的名称。
语法
BOOL GetKeyboardLayoutNameA(
[out] LPSTR pwszKLID
);
参数
[out] pwszKLID
类型:LPTSTR
接收输入区域设置标识符名称(包括终止 null 字符)的缓冲区(长度至少为 KL_NAMELENGTH 个字符)。 这是提供给 LoadKeyboardLayout 函数的字符串的副本,除非进行了布局替换。
有关 Windows 提供的输入布局的列表,请参阅适用于 Windows的
返回值
类型:BOOL
如果函数成功,则返回值为非零。
如果函数失败,则返回值为零。 若要获取扩展的错误信息,请调用 GetLastError。
言论
输入区域设置标识符是比键盘布局更广泛的概念,因为它还可以包含语音转文本转换器、输入法编辑器(IME)或任何其他形式的输入。
从 Windows 8 开始 : 检索与当前键盘布局或输入法关联的语言的首选方法是调用 Windows.Globalization.Language.CurrentInputMethodLanguageTag。 如果应用将语言标记从
注意
winuser.h 标头将 GetKeyboardLayoutName 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
支持的最低服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | 窗户 |
标头 | winuser.h (包括 Windows.h) |
库 | User32.lib |
DLL | User32.dll |
另请参阅
概念
参考