INFO: Informing the Terminal Server of Windows Based Terminal (WBT) Keyboard Layout (260333)



The information in this article applies to:

  • Microsoft Windows CE Platform Builder 2.11
  • Microsoft Windows CE Platform Builder 2.12

This article was previously published under Q260333

SUMMARY

Multiple keyboard layout support for a Windows Based Terminal (WBT) can be added by original equipment manufacturers (OEM) adaptation of the keyboard driver. However, the Windows CE operating system does not support the localization API to query the current keyboard layout.

To provide a consistent user experience through the transition from local WBT applications and dialog boxes to an RDP session with a Windows Terminal Server, the Terminal Server Client needs to inform the Terminal Server of the local keyboard layout. This is done by using a registry setting.

The text string for the keyboard layout name must be set as follows in the registry:

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Terminal Server Client]
"Keyboard Layout"="0000040C"   ;French
					

The OEM user interface that allows the keyboard layout to be changed on the WBT device should also update this registry key. The registry key is queried as an RDP session is established. If this key is changed after an RDP session is established, Terminal Server will not be notified that a layout change occurred.

MORE INFORMATION

The documentation that is provided with the WBT adaptation kit does not provide enough detail on the data type of this registry value. The registry value must be of type STRING even though the keyboard layout ID appears to be a hexadecimal or dword value.

This following setting is not correct:

"Keyboard Layout"=dword:0000040C
					


Modification Type:MinorLast Reviewed:12/27/2003
Keywords:kbdocerr kbinfo KB260333