getKeyboardLayoutList 函数 (winuser.h)

检索与系统中的当前输入区域设置集相对应的输入区域设置标识符（以前称为键盘布局句柄）。该函数将标识符复制到指定的缓冲区。

语法

int GetKeyboardLayoutList(
  [in]  int nBuff,
  [out] HKL *lpList
);

[in] nBuff

类型： int

缓冲区可以容纳的最大句柄数。

[out] lpList

类型： HKL*

指向接收输入区域设置标识符数组的缓冲区的指针。

类型： int

如果函数成功，则返回值是复制到缓冲区的输入区域设置标识符的数目;如果 nBuff 为零，则返回值是接收所有当前输入区域设置标识符所需的缓冲区的大小（以数组元素为单位）。

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

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

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


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

概念性

GetKeyboardLayout

引用