Share via

GetKeyboardLayoutName

  • Article

This function retrieves the name of the active keyboard layout.

BOOL GetKeyboardLayoutName( 
  LPTSTR pwszKLID 
);

Parameters

  • pwszKLID
    [in] Pointer to the buffer of at least KL_NAMELENGTH characters that is to receive the name of the keyboard layout, including the terminating null character.

Return Values

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

The layout name is read from the registry and not from the loaded keyboard layout. Windows CE does not support the LoadKeyboardLayout function or any other keyboard layout function. Therefore, to change the keyboard layout name, use an application, such as a Control Panel program, that changes the Active entry in the following registry subkey:

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\KeyboardLayout

The value of the Active entry identifies the system keyboard layout. Its type is REG_SZ.

To use a newly specified keyboard layout, the user must reset the device.

Requirements

OS Versions: Windows CE 2.10 and later.
Header: Winuser.h.
Link Library: Kbdui.lib.

See Also

Keyboard Functions

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.