平台 SDK: Windows 用户接口

GetKeyboardLayoutList

GetKeyboardLayoutList函数检索与系统中当前输入语言环境集相对应的输入语言环境标识符(以前称为键盘布局句柄)。 该函数将标识符复制到指定的缓冲区。

UINT GetKeyboardLayoutList(
  int nBuff,       // 数组的大小
  HKL FAR *lpList  // 输入区域设置标识符数组
);

参数

  • nBuff

  • [in] 指定缓冲区可容纳的句柄的最大数量。

  • lpList

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

返回值

如果函数成功,则返回值是复制到缓冲区的输入区域设置标识符的数量,或者如果nBuff为零,则返回值是接收所有当前输入区域设置标识符所需的缓冲区在数组元素中的大小。

如果函数失败,返回值为零。 要获得扩展的错误信息,请调用GetLastError。

备注

输入区域标识符比键盘布局更广泛,因为它也可以包含语音到文本转换器,IME或任何其他形式的输入。

要求

  Windows NT/2000/XP: 包含在Windows NT 3.51和更高版本中。

  Windows 95/98/Me: 包含在Windows 95和更高版本中。

  头文件: 声明于 Winuser.h; 包含于 Windows.h.
  库: 使用 User32.lib.