Configuring the Terminal Services Client (Windows Embedded CE 6.0)

1/5/2010

The Windows Embedded CE Terminal Services Client (CETSC) is configured by the Terminal Server Client registry key, HKEY_LOCAL_MACHINE\Software\Microsoft\Terminal Server Client. This registry key is defined in rdp.reg at %_WINCEROOT%\PUBLIC\RDP\OAK\FILES.

For more information about CETSC, see Windows Embedded CE Terminal Services Client (CETSC).

CETSC Configuration

The following table shows the named values that are used to configure CETSC on a Windows Embedded CE powered thin client.

Value Description

CEConfig

This value indicates whether CETSC runs in the Windows Thin Client Shell.

The following list shows the available settings:

  • "WBT" indicates that CETSC is running in a Windows Thin Client Shell. This is when SYSGEN_WBTSHELL = 1.
  • "Maxall" indicates that CETSC is not running the Windows Thin Client Shell. This is used in all other OS designs.

The default setting is "WBT".

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 display the CETSC UI.
  • 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 file storage redirection is enabled and the clipboard tries to copy a file.
  • The CETSC UI appears in the Windows thin client when the dialog box for enabling file storage redirection is canceled.
  • Keyboard shortcut messages might be sent to remote sessions.

BitmapPersistCacheLocation

This value indicates the location of the bitmap cache.

The default value is \Temp.

DisableFileAccess

This value 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.

The default value is 1.

FullScreenAlways

This value indicates whether full-screen mode is enabled.

The default value for a 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 registry key example shows the registry settings in rdp.reg that associate .rdp files by using 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.

CETSC User Preferences

When a thin client includes the Windows Thin Client Shell and is deployed and run, user preferences are stored in the HKey_Current_User\Software\Microsoft\Terminal Server Client\Default registry key.

Note

This information is comparable to what is included in the .rdp file when a shell other than the Windows Thin Client Shell is used.

The following table shows the named values in this registry key.

Registry Key Default value Description

alternate shell

" "

Determines whether a program is started automatically when you connect with RDP. This setting corresponds to the Program path and file name box on the Programs tab of the Remote Desktop Connection client.

To specify an alternate shell, the value is a valid path to an executable file, for example, "C:\ProgramFiles\Office\word.exe".

This setting also determines the path or the alias of the Remote Application to be started at connection time if RemoteApplicationMode is enabled.

This registry value is a string.

audioMode

0

Indicates where the audio plays.

This setting corresponds to the Remote computer sound box on the Local Resources tab of Remote Desktop Connection client. A value of zero (0) indicates that the audio plays on the host server. A value of 1 indicates that the audio plays on the Remote Desktop device. A value of 2 indicates that the audio does not play.

authentication level

2

Defines the server authentication level settings.

A value of 0 indicates none. A value of 1 indicates that server authentication is required. A value of 2 indicates that server authentication is negotiable. A value of 3 indicates that server authentication is unspecified.

This registry value is an integer.

autoReconnectionEnabled

1

Indicates whether an attempt is made to automatically reconnect to the host if a connection is lost. A value of 1 indicates that the client computer automatically tries to reconnect. A value of zero (0) indicates that the Remote Desktop device automatically tries to reconnect.

bitmapCacheSize

1500

Specifies the size, in KB, of the bitmap cache in memory. The maximum value is 32000.

This registry value is an integer.

bitmapPersistCacheLocation

\Temp

Indicates the location of the bitmap cache.

This registry value is a string.

compression

1

Enables file and directory compression. Compression is on by default and it is recommended that it remain so.

A value of 1 indicates that compression is enabled.

connect to console

0

Used only in non-Windows-based Thin Client configurations. It enables the console to connect to from the command line. A value of zero (0) indicates that the command connects to a Terminal Services session. A value of 1 indicates that the command connects to the host console session.

Windows XP Professional ignores this setting.

desktopheight

0

Indicates the height of the display, in pixels. The default value is the resolution that the operating system uses when it starts up.

This value can range from 200 to 2048 pixels.

desktopwidth

0

Indicates the width of the display, in pixels. The default value is the resolution that the operating system uses when it starts up.

This value can range from 200 to 4096 pixels.

disable cursor setting

0

Indicates whether cursor blinking is enabled during a Terminal Services session.

A value of 1 indicates that cursor blinking is not available. A value of 0 indicates that cursor blinking is enabled.

disable full window drag

1

Indicates whether the contents of a graphical window are visible while the user drags it in a Terminal Services session. A value of 1 indicates that the contents of the window do not appear while the user drags it. A value of zero (0) indicates that the contents of the window do appear while the user drags it.

This setting corresponds to the Show contents of window while dragging box on the Experience tab of the Remote Desktop Connection client.

disable menu anims

1

Indicates whether menu and window animations are enabled or disabled. A value of 1 indicates that animations are not permitted. A value of zero (0) indicates that animations are allowed.

This setting corresponds to the Menu and window animation box on the Experience tab of the Remote Desktop Connection client.

disable themes

0

Indicates whether themes are permitted when you log on to a remote server. A value of zero (0) indicates that themes are permitted. A value of 1 indicates that themes are not available.

This setting corresponds to the Themes box on the Experience tab of the Remote Desktop Connection client.

disable wallpaper

1

Indicates whether wallpaper is disabled or enabled. A value of 1 indicates that wallpaper is enabled. A value of zero (0) indicates that wallpaper is not available.

This setting corresponds to the Desktop background box on the Experience tab of the Remote Desktop Connection client.

displayconnectionbar

1

Indicates whether the connection bar is displayed on the remote desktop when in full screen mode.

This setting corresponds to the selection in the Display the connection bar when in full screen mode box on the Display tab of the Remote Desktop Connection client.

EnableCredSspSupport

1

Enables support for CredSSP, if it is present on the Remote Desktop device.

A value of 0 indicates that CredSSP support is off, and a value of 1 indicates that it is on.

keyboardhook

2

Indicates whether Windows key combinations are applied. A value of zero (0) indicates that Windows key combinations are applied locally on the Remote Desktop device. A value of 1 indicates that they are applied on the remote server. A value of 2 indicates that they are applied in full-screen mode only.

This setting corresponds to the selection in the Keyboard box on the Local Resources tab of the Remote Desktop Connection client.

redirectclipboard

1

Indicates whether the clipboard will be automatically redirected during a Terminal Services session.

A value of 0 indicates that clipboard redirection is not available. A value of 1 indicates that clipboard redirection is enabled.

redirectdrives

0

Indicates whether disk drives are automatically redirected when you log on to a remote server. A value of 1 indicates that drive redirection is on. A value of zero (0) indicates that drive redirection is off.

This setting corresponds to the Disk Drives box on the Local Resources tab of Remote Desktop Connection client.

redirectcomports

0

Indicates whether COM ports are automatically redirected when you connect to a remote server. A value of 1 indicates that COM port redirection is on. A value of zero (0) indicates that COM port redirection is off.

This setting corresponds to the Serial Ports box on the Local Resources tab of the Remote Desktop Connection client.

redirectprinters

1

Indicates whether printers are automatically redirected when you log on to a remote server. A value of 1 indicates that printer redirection is on, and a value of zero (0) indicates that it is off.

This setting corresponds to the Printers box on the Local Resources tab of Remote Desktop Connection client.

redirectsmartcards

1

Specifies whether redirection of Smart Cards is permitted during server authentication. A value of 1 indicates that redirection of Smart Cards is on. A value of zero (0) indicates that redirection of Smart Cards is off.

This setting corresponds to the Smart cards box on the Local Resources tab of Remote Desktop Connection client.

Screen Mode Id

0

Indicates whether the remote desktop will be displayed in full-screen mode or normal mode.

A value of 0 indicates full-screen mode. A value of 1 indicates window mode.

session bpp

Defaults to the bit depth of the local system

Defines the bits-per-pixel (bpp) depth for a session.

It can be one of the following:

  • 4 – 4 bpp
  • 8 – 8 bpp
  • 15 – 15 bpp
  • 16 – 16 bpp
  • 24 – 24 bpp
  • 32 – 32 bpp

This setting corresponds to the color depth that you select in Colors on the Display tab of the Remote Desktop Connection client.

shell working directory

" "

If an alternate shell was specified, this value is a string that indicates a valid path to the folder in which the application that is started up automatically is located.

This setting corresponds to the Program path and file name box on the Programs tab of the Remote Desktop Connection client.

Span Monitors

0

Enables monitor spanning.

A value of 0 indicates monitor spanning is not available. A value of 1 indicates that monitor spanning is enabled.

To configure CETSC for thin clients that are using the Windows Thin Client Shell

  1. In Platform Builder, on the File menu, select Open, and then select File.

  2. In Files of type, select All Files.

  3. Navigate to the %_WINCEROOT%\PUBLIC\RDP\OAK\FILES folder.

  4. Select rdp.reg and click Open.

  5. In the rdp.reg, type directly in the file to add the named values in the HKEY_LOCAL_MACHINE\Software\Microsoft\Terminal Server Client registry key or in the HKey_Current_User\Software\Microsoft\Terminal Server Client\Default registry key.

  6. On the File menu, select Save rdp.reg.

Note

During the build process, makeimg.exe processes all .reg files in the build directories to create a single file, Reginit.ini. Reginit.ini forms the basis for the system registry.

See Also

Concepts

Configuring the Windows Thin Client Shell
Thin Client Registry Settings
Changing Thin Client Registry Settings

Other Resources

Terminal Services Client Configuration through the .rdp File