Configuring the Terminal Services Client (Windows CE 5.0)

  • Article

Send Feedback

The Terminal Services Client is controlled by the Terminal Server Client node in the registry. The HKEY_LOCAL_MACHINE\Software\Microsoft\Terminal Server Client registry key controls the configuration of the Terminal Services Client. The following table shows the named values.

Value Description
CEConfig Default setting is "WBT". The following list shows the available settings:
  • "WBT" indicates that the Terminal Services Client is running in a Windows Thin Client Shell. This is when SYSGEN_WBTSHELL = 1.
  • "Maxall" indicates that the Terminal Services Client is not running the Windows Thin Client Shell. This is used in all other OS designs.

The following list shows the behavior when WBT is set:

  • File change notifications through protected server library (PSL) calls are disabled.
  • The Windows Thin Client Shell does not bring up the Windows CE Terminal Services Client (CETSC) user interface.
  • Keyboard hooks are disabled for the Windows Thin Client Shell.
  • Additional registry migration occurs for Windows Thin Client OS designs because the connections are started through registry settings and not through .rdp files.

The following list describes issues that a Windows Thin Client might encounter if this value is set to "Maxall":

  • The Filesys.exe may crash when drive redirection is enabled and an attempt is made to copy a file by using the clipboard.
  • The CETSC user interface appears in the Windows Thin Client when the dialog box about enabling drive redirection is cancelled.
  • Hot key messages might be sent to remote sessions.
BitmapPersistCacheLocation Default setting is \Temp. This setting indicates the location of the bitmap cache.
DisableFileAccess Default setting is 1. This setting indicates whether the user has access to the local file system. A value of 1 indicates that access to the local file system is disabled and the Save As and Open buttons are not available in the UI. A value of zero (0) indicates that the user has access to the local file system.
FullScreenAlways Default setting ifor the Thin Client is 1. You should not change this value.

When this value is 1, windowed mode is disabled and the session is always run in full-screen mode.

The following code example shows the registry settings in Rdp.reg that associate .rdp files with CETSC.

[HKEY_CLASSES_ROOT\.rdp]
    @="rdpfile"
[HKEY_CLASSES_ROOT\rdpfile]
    @=LOC_RDPCONNECTION
[HKEY_CLASSES_ROOT\rdpfile\DefaultIcon]
    @="\\Windows\\cetsc.exe,-101"
[HKEY_CLASSES_ROOT\rdpfile\Shell\Open\Command]
    @="\\Windows\\cetsc.exe %1"

For more information, see RDP Registry Settings.

Additionally, when a Thin Client that has the Windows Thin Client Shell is deployed and run, user preferences are stored in the HKey_Current_User\Software\Microsoft\Terminal Server Client\Default registry key. This information is comparable to what is included in the .rdp file when a shell other than the Thin Client Shell is used. The following table shows the named values in this key.

Value Description
AudioRedirectionMode Default setting is 0. This setting indicates where the audio plays. A value of zero (0) indicates that the audio plays on the host computer. A value of 1 indicates that the audio plays on the remote device. A value of 2 indicates that the audio does not play.
AutoReconnectionEnabled Default setting is 1. This setting indicates whether an attempt is made to automatically reconnect to the host if a connection is lost. A value of 1 indicates that automatic reconnection is enabled, and a value of zero (0) indicates that it is disabled.
BBarEnabled Default setting is 1. This setting indicates whether to display the connection bar. A value of zero (0) indicates that the connection bar is not displayed, and a value of 1 indicates that it is displayed.
BBarShowMinimizeBtn Default setting is 1. Indicates whether to display the minimize button on the connection bar. A value of zero (0) indicates that the minimize button is not displayed. A value of 1 indicates that it is displayed.
BBarShowPinBtn Default setting is 0. Indicates whether the pin button on the connection bar is displayed. A value of zero (0) indicates that pin button is not displayed, the connection bar remains on top, and all server output will appear below it. A value of 1 indicates that the pin button is displayed so that a user can unpin the connection bar from the UI.
BBarShowRestoreBtn Default setting is 1. Indicates whether to display the restore button on the connection bar. A value of zero (0) indicates that the restore button is not displayed. A value of 1 indicates that it is displayed.
BBarPinned Default setting is 1. Indicates whether to pin the connection bar to the shell. A value of zero (0) indicates that the connection bar is hidden automatically when the cursor is moved away from the connection bar. A value of 1 indicates that the connection bar is always displayed.
BitmapCacheSize Default setting is 1500. Specifies the size, in KB, of the bitmap cache in memory. The maximum value is 32000.
BitmapPersistCacheLocation Default setting is \Temp. Indicates the location of the bitmap cache.
BitmapPersistenceEnabled Default setting is 0. This setting indicates whether bitmap caching is selected. A value of zero (0) indicates that bitmap caching is not selected, and a value of 1 indicates that it is selected.
ColorDepthID Default setting is 24. This setting indicates the color depth in bits per pixel (bpp). A value of zero (0) indicates 4 bpp. A value of 1 indicates 8 bpp. A value of 2 indicates 15 bpp. A value of 3 indicates 16 bpp. A value of 4 indicates 24 bpp.
Compress Default setting is 1. This setting enables file and directory compression. Compression is on by default and it is recommended that it remain so.
ConnectToServerConsole Default setting is 0. This setting is used only in non-Windows-based Thin Client run-time images. It indicates the console to connect to from the command line. A value of zero (0) indicates that the command connects to a Terminal Services session. Windows XP Professional ignores this setting. A value of 1 indicates that the command connects to the host console.
desktopheight Default setting is 1024. This setting indicates height of the display, in pixels.
desktopwidth Default setting is 1280. This setting indicates the width of the display, in pixels.
disable full window drag Default setting is 1. This setting indicates whether full window drag capability is enabled or disabled. A value of 1 indicates that full window drag is enabled, and a value of zero (0) indicates that it is disabled.
disable menu anims Default setting is 1. This setting indicates whether menu animation is enabled or disabled. A value of 1 indicates that animation is enabled, and a value of zero (0) indicates that it is disabled.
disable themes Default setting is 0. This setting indicates whether themes are enabled or disabled. A value of 1 indicates that themes are enabled, and a value of zero (0) indicates that themes are disabled.
disable wallpaper Default setting is 1. This setting indicates whether wallpaper is disabled or enabled. A value of 1 indicates that wallpaper is enabled, and a value of zero (0) indicates that it is disabled.
DisableFileAccess Default setting is 1. Indicates whether the user has access to the local file system. A value of 1 indicates that access to the local file system is disabled and the Save As and Open buttons are not available in the UI. A value of zero (0) indicates that the user has access to the local file system.
domain Indicates the domain of the person who can log on to the remote device. There is no default.
EnableDriveRedirection Default setting is 1. This setting indicates whether drive redirection is enabled. A value of 1 indicates that drive redirection is on, and a value of zero (0) indicates that it is off.
EnablePortRedirection Default setting is 1. This setting indicates whether COM port redirection is enabled. A value of 1 indicates that COM port redirection is on, and a value of zero (0) indicates that it is off.
EnablePrinterRedirection Default setting is 1. This setting indicates whether printer redirection is enabled. A value of 1 indicates that printer redirection is on, and a value of zero (0) indicates that it is off.
EnableSCardRedirection Default setting is 1. This setting indicates whether redirection of smart cards is allowed. A value of 1 indicates that redirection of smart cards is on, and a value of zero (0) indicates that it is off.
KeyboardHookMode Default setting is 2. This setting indicates what is displayed when ALT-TAB is pressed on the keyboard. A value of zero (0) indicates items on the local device are displayed. A value of 1 indicates items on the remote device are displayed. A value of 2 indicates that the device is full-screen only.
MaxReconnectAttempts Default setting is 20. This setting indicates the maximum number of attempts that are made to reconnect to the host after a connection is lost.
MCSPort Used only in non-Windows-based Thin Client run-time images. It indicates the alternate Winsock port for the RDP.
Password Indicates the password of the person identified in the UserName value.
Note   Windows CE reads saved passwords, but does not have the ACLs to securely write passwords.
ServerName Specifies the IP address of the remote device.
StartFullScreen Default setting is 1. This setting indicates whether the terminal service session starts in full screen. A value of 1 indicates that the session starts in full screen, and a value of zero (0) indicates that it does not.
AlternateShell Indicates the alternate shell or startup application.
UserName Indicates the user name of a person who can log on to the remote device.
WorkingDir Indicates the folder that contains the alternate shell or startup application.

See Also

Thin Client Registry Settings | Terminal Services Client Configuration through the .rdp File

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.