This function retrieves the name of the active keyboard layout.
At a Glance
| Header file: | Winuser.h |
| Windows CE versions: | 2.10 and later |
Syntax
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 applet, 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.