Terminal Services Client Configuration through the .rdp File

Terminal Services Client Configurat...

Platform Builder for Microsoft Windows CE 5.0

When an OS that contains RDP is deployed and run in a remote location, a default file with the extension .rdp is created that contains user preferences. Additionally, when using a shell other than the Thin Client Shell, these preferences can be applied during the RDP session. You can edit this file with using the Windows CE Terminal Services Client (CETSC) or in Notepad.

Note If a Windows Thin Client Shell is used, these settings are saved in the registry rather than in an .rdp file. For more information, see Configuring the Terminal Services Client.

The following table shows the valid keywords, types, and sample values for the .rdp file. Valid types are "s" for string and "i" for integer.

Keyword:type:value	Description
AudioRedirectionMode:i:0	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:i:1	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. A value of zero (0) indicates that it is disabled.
BBarEnabled:i:1	Indicates whether to display the connection bar. A value of zero (0) indicates that the connection bar is not displayed. A value of 1 indicates that it is displayed.
BBarShowMinimizeBtn:i: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.
BbarShowPinButton:i: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:i: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:i: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:i:1500	Specifies the size, in KB, of the bitmap cache in memory. The maximum value is 32000.
BitmapPersistCacheLocation:s:\Temp	Indicates the location of the bitmap cache.
BitmapPersistenceEnabled:i:0	Indicates whether bitmap caching is selected. A value of zero (0) indicates that bitmap caching is not selected. A value of 1 indicates that it is selected.
ColorDepthID:i:4	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. The default value is either 24bpp, or the color depth at which the OS boots, whichever is less.
Compress:i:1	Enables file and directory compression. Compression is on by default and it is recommended that it remain so.
ConnectToServerConsole:i:0	Used only in non-Windows-based Thin Client configurations. 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:i:1024	Indicates height of the display, in pixels. The default value is the resolution at which the OS boots.
desktopwidth:i:1280	Indicates width of the display, in pixels. The default value is the resolution at which the OS boots.
disable full window drag:i:1	Indicates whether full window drag capability is enabled or disabled. A value of 1 indicates that full window drag is enabled. A value of zero (0) indicates that it is disabled.
disable menu anims:i:1	Indicates whether menu animation is enabled or disabled. A value of 1 indicates that animation is enabled. A value of zero (0) indicates that it is disabled.
disable themes:i:0	Indicates whether themes are enabled or disabled. A value of 1 indicates that themes are enabled. A value of zero (0) indicates that themes are disabled.
disable wallpaper:i:1	Indicates whether wallpaper is disabled or enabled. A value of 1 indicates that wallpaper is enabled. A value of zero (0) indicates that it is disabled.
DisableFileAccess:i: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:s:C1554501-A	Indicates the domain of the person who can log on to the remote device. There is no default.
EnableDriveRedirection:i:1	Indicates whether drive redirection is enabled. A value of 1 indicates that drive redirection is on. A value of zero (0) indicates that it is off.
EnablePortRedirection:i:1	Indicates whether COM port redirection is enabled. A value of 1 indicates that COM port redirection is on. A value of zero (0) indicates that it is off.
EnablePrinterRedirection:i:1	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:i:1	Specifies whether redirection of smart cards is allowed. A value of 1 indicates that redirection of smart cards is on. A value of zero (0) indicates that it is off.
KeyboardHookMode:i:2	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:i:20	Indicates the maximum number of attempts that are made to reconnect to the host after a connection is lost.
MCSPort:i:3389	Indicates the alternate Winsock port for the RDP. The default value is 3389. Change this value to an appropriate value if the terminal server is listening on a different port.
Password:s:<password>	Indicates the password of the person identified in the UserName keyword. Note Windows CE reads saved passwords, but does not have the ACLs to securely write passwords.
ServerName:s:65.4.18.	Specifies the IP address of the remote device.
StartFullScreen:i:1	Indicates whether the Terminal Service session starts in full screen. A value of 1 indicates that the session starts in full screen. A value of zero (0) indicates that it does not.
AlternateShell:s:<startup shell or application>	Indicates the alternate shell or startup application to use in a session. Note You can restrict usage after a user logs in by setting this value to a specific application on the server. The user will only be allowed to use the application that you specify.
UserName:s:<name>	Indicates the user name of a person who can log on to the remote device.
WorkingDir:s:<folder>	Indicates the folder that contains the alternate shell or startup application.

You associate .rdp files with CETSC through the registry. The following example shows how to make this association in Rdp.reg.

[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"

See Also