Remote Desktop Connection Registry Settings (Compact 7)

3/12/2014

You can configure Remote Desktop Connection by using the Remote Desktop Connection registry settings.

User Preferences

If the OS uses the Windows Thin Client Shell, you can configure user preferences for Remote Desktop Connection by using the following entries, located in the key HKEY_CURRENT_USER\Software\Microsoft\Terminal Server Client\Default.

Many of the settings in the device registry also correspond to options in the device's Remote Desktop client user interface (UI).

Note

If the OS uses the Windows Embedded Compact Standard Shell, you must instead configure these user preferences by using the corresponding keywords located in the .rdp file. See Remote Desktop Connection .rdp File Keywords for more information.

Name Type Description Default Value

alternate shell

REG_SZ

Specifies the path to the server program that starts automatically when you connect to the server with Remote Desktop Protocol (RDP), for example, "C:\ProgramFiles\Office\Word.exe."

In the Remote Desktop Connection dialog box, on the Programs tab, corresponds to the Program path and file name box

" "

audioMode

REG_DWORD

Indicates where audio plays.

  • Set to 0 (zero) to play audio on the host server.
  • Set to 1 to play audio on the device.
  • Set to 2 to prevent playing audio.

In the Remote Desktop Connection dialog box, on the Local Resources tab, corresponds to the Remote audio Settings button.

0

authentication level

REG_DWORD

Defines the server authentication level

  • Set to 0 (zero) to establish a connection to a Terminal Server without authenticating the connection to the server.
  • Set to 1 to require a valid Transport Layer Security (TLS) certificate from the Terminal Server to authenticate the connection to the server.
  • Set to 2 to try to use TLS to authenticate the connection to the server. If either the server or the device does not support TLS, the device still establishes a connection.

2

autoReconnection Enabled

REG_DWORD

Indicates how the device and server automatically try to reconnect if the connection is lost.

Set to 0 (zero) for the device to try to reconnect to the server. Set to 1 for the server to try to reconnect to the device.

1

bitmapCacheSize

REG_DWORD

The size, in KB, of the bitmap cache in memory. The system attempts to allocate approximately twice this amount of memory. If the allocation attempt fails, the system disables persistent caching for bitmaps and uses RAM caching instead.

1500

bitmapPersistCacheLocation

REG_SZ

The location of the bitmap cache.

\Temp

compression

REG_DWORD

Enables file and directory compression.

Set to 1 to enable compression. Set to 0 to disable compression.

1

connect to console

REG_DWORD

Enables the host console session to connect from the command line.

Set to 0 (zero) for the command line to connect to a Terminal Services session. Set to 1 for the command line to connect to the host console session.

This setting only works when you connect to a computer running Windows Server 2003.

Windows XP Professional does not respond to this setting because it always connects the user to the console.

Windows NT 4.0 Terminal Server Edition and Windows 2000 Server with Terminal Services do not support this setting.

0

desktopheight

REG_DWORD

The height of the display, in pixels.

This value can range from 200 to 2048.

0

When set to 0 (zero), the default value becomes the height value of the resolution dimensions that the OS uses when it starts.

desktopwidth

REG_DWORD

The width of the display, in pixels.

This value can range from 200 to 4096.

0

When set to 0, the default value becomes the width value of resolution dimensions that the OS uses when it starts.

disable cursor setting

REG_DWORD

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

Set to 0 (zero) to enable cursor blinking. Set to 1 to disable cursor blinking.

0

disable full window drag

REG_DWORD

Indicates whether the contents of a window are visible while the user drags it in a Terminal Services session.

Set to 0 (zero) to display the contents of the window. Set to 1 to not display the contents of a window.

In the Remote Desktop Connection dialog box, on the Experience tab, corresponds to the Show contents of window while dragging check box

1

disable menu anims

REG_DWORD

Indicates whether menu and window animations are enabled.

Set to 0 (zero) to enable animations. Set to 1 to disable animations.

In the Remote Desktop Connection dialog box, on the Experience tab, corresponds to the Menu and window animation check box.

1

disable themes

REG_DWORD

Indicates whether themes are permitted when you log on to a remote server.

Set to 0 (zero) to enable themes. Set to 1 to disable themes.

In the Remote Desktop Connection dialog box, on the Experience tab, corresponds to the Themes check box.

0

disable wallpaper

REG_DWORD

Indicates whether wallpaper is enabled.

Set to 0 (zero) to disable wallpaper. Set to 1 to enable wallpaper.

In the Remote Desktop Connection dialog box, on the Experience tab, corresponds to the Desktop background check box.

1

displayconnectionbar

REG_DWORD

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

Set to 0 (zero) to remove the connection bar. Set to 1 to display the connection bar.

In the Remote Desktop Connection dialog box, on the Display tab, corresponds to the Display the connection bar when in full-screen mode check box.

1

EnableCredSspSupport

REG_DWORD

Enables support for Credential Security Support Provider protocol (CredSSP) if it is present on the Remote Desktop device.

Set to 0 to disable support. Set to 1 to enable support.

1

keyboardhook

REG_DWORD

Indicates whether Windows key combinations will work on the server.

Set to 0 (zero) to disable support for Windows key combinations on the server.

To enable Windows key combinations, set to one of the following:

  • Set to 1 to enable support for Windows key combinations on the server.
  • Set to 2 to enable support for Windows key combinations on the server only while in full-screen mode.

In the Remote Desktop Connection dialog box, on the Local Resources tab, corresponds to the Keyboard drop-down list.

2

redirectclipboard

REG_DWORD

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

Set to 0 (zero) to disable clipboard redirection. Set to 1 to enable clipboard redirection.

1

redirectdrives

REG_DWORD

Indicates whether disk drives are automatically redirected when the user logs on to a remote server.

Set to 0 (zero) to disable drive redirection. Set to 1 to enable drive redirection.

In the Remote Desktop Connection dialog box, on the Local Resources tab, corresponds to the Disk Drives check.

0

redirectcomports

REG_DWORD

Indicates whether COM ports are automatically redirected when the user connects to a remote server.

Set to 0 (zero) to disable COM port redirection. Set to 1 to enable COM port redirection.

In the Remote Desktop Connection dialog box, on the Local Resources tab, corresponds to the Serial Ports box.

0

redirectprinters

REG_DWORD

Indicates whether printers are automatically redirected when the user logs on to a remote server.

Set to 0 (zero) to disable printer redirection. Set to 1 to enable printer redirection.

In the Remote Desktop Connection dialog box, on the Local Resources tab, corresponds to the Printers check box.

1

redirectsmartcards

REG_DWORD

Indicates whether the device redirects Smart Cards during server authentication.

Set to 0 (zero) to disable redirection of Smart Cards. Set to 1 to enable redirection of Smart Cards.

In the Remote Desktop Connection dialog box, on the Local Resources tab, corresponds to the Smart cards check box.

1

Screen Mode Id

REG_DWORD

Indicates whether the device displays the remote desktop in full-screen mode or normal mode.

Set to 0 (zero) to display it in full-screen mode. Set to 1 to display it in normal mode, in which it is displayed inside a window on the desktop.

0

session bpp

REG_DWORD

Defines the bits per pixel (bpp) depth for an RDP session.

Set to one of the following:

  • 15   15 bpp
  • 16   16 bpp
  • 24   24 bpp
  • 32   32 bpp

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

Uses the bit depth of the local system

shell working directory

REG_SZ

If an alternate shell was specified, this value indicates a valid path of the folder in which the startup application is located.

In the Remote Desktop Connection dialog box, on the Programs tab, corresponds to the Program path and file name .

" "

Span Monitors

REG_DWORD

Enables monitor spanning.

Set to 0 (zero) to disable monitor spanning. Set to 1 to enable monitor spanning.

0

Remote Server

For information about server-side application programming, configurable settings, and server-side registry settings, see Remote Desktop Services.

Terminal Services Client Connections

You can configure settings for all Terminal Services Client connections by using the following entries, located in the key HKEY_CURRENT_USER\Software\Microsoft\Terminal Server Client.

Note

These registry settings set the size of the bitmap cache and the persistent bitmap cache for all connections.

Name Type Description Default value

BitmapCacheSize

REG_DWORD

The size, in KB, of the bitmap cache in memory. The maximum value is 32,000 KB.

1,500

BitmapPersistCacheSize

REG_DWORD

The size, in KB, of the bitmap cache file.

10

RequireVKPackets

REG_DWORD

Reserved for Microsoft use.

0

Drive Redirection

Drive redirection redirects the path of a drive on a remote server to a new location on the local device. You can configure drive redirection by using the following registry entry, located in the key HKEY_CURRENT_USER\Software\Microsoft\Terminal Server Client\<Connection Name>.

Name Type Description Default value

EnableDriveRedirection

REG_DWORD

Set to 1 to enable drive redirection. Set to 0 (zero) to disable drive redirection.

1

If drive redirection is enabled, you can configure the folder redirection filter by using the following entry, located in the key HKEY_LOCAL_MACHINE\System\StorageManager\AutoLoad\FilterFsd.

Name Type Description Default value

RootPath

REG_SZ

The root directory that is available within the RDP session.

Set to "\\" to make all of the file system available.

"\\"

Terminal Server Client Configuration

You can configure the Terminal Services Client by using the following registry entries, located in the key HKEY_LOCAL_MACHINE\Software\Microsoft\Terminal Server Client.

Name Type Description Default value

BitmapPersistCacheLocation

REG_SZ

The path of the folder where the cache file is stored.

\temp

CEConfig

REG_SZ

Indicates whether Terminal Services Client runs in the Windows Thin Client Shell.

Set to one of the following:

  • WBT to run the Terminal Services Client in a Windows Thin Client Shell. This value is set when SYSGEN_WBTSHELL = 1. When WBT is set:

Windows Embedded Compact disables file change notifications through protected server library (PSL) calls.

Windows Embedded Compact disables keyboard hooks 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.
  • Maxall to run the Terminal Services Client in a program other than the Windows Thin Client Shell.
    The following list describes issues that a Windows Thin Client might encounter if this value is set to Maxall :
    • The Filesys.exe may stop responding when drive redirection is enabled and an attempt is made to copy a file by using the clipboard.

The Windows Embedded Compact Terminal Services Client CETSC user interface appears in the Windows Thin Client Shell when the user closes the dialog box to enable drive redirection.

  • Keyboard shortcut messages might be sent to remote sessions.

Maxall

CEDisableRFXDecoder

REG_DWORD

Explicitly disables RemoteFX on a RemoteFX-enabled device.

Set to 0 (zero) to enable the RemoteFX decoder. Set to 1 to disable the RemoteFX decoder.

0

DisableFileAccess

REG_DWORD

Indicates whether the user has access to the local file system.

Set to 0 (zero) to enable access to the local file system. Set to 1 to disable access to the local file system and to hide the Save As and Open options on the context menus of the UI of the client device OS.

1

DisableRDP7BitmapCompression

REG_DWORD

Disables the support for Remote Desktop Protocol 7.0 bitmap compression on RDP Client.

When establishing a RemoteFX session, the server may send non-RemoteFX data to the client in addition to RemoteFX data. Non-RemoteFX data may use an RDP 7.0 bitmap codec for compression, which requires support for the Streaming SIMD Extensions 2 (SSE2) instruction set in the processor. If a platform does not support the SSE2 instruction set, the RDP 7.0 bitmap codec will not be used.

Set to 0 (zero) to enable the codec. Set to 1 to disable the codec.

0

FullScreenRFXOnly

REG_DWORD

Enables full-screen-only mode for hardware-assisted RemoteFX and disables the Graphics Device Interface (GDI) (or windowed) mode. The FullScreenRFXOnly setting is not used in software decoding in RemoteFX. If this setting is used with software decoding, the contents of the device display screen might not update. When FullScreenRFXOnly is enabled, the RDP client does not call the ESCAPE_COPY_2BMP escape function. When this key is enabled, the RDP client will not present any RemoteFX data on screen and it becomes the responsibility of the display driver to handle the display of decoded RemoteFX data. When this key is enabled the blue connection bar will be hidden in RemoteFX sessions.

Set to 0 (zero) to disable support. Set to 1 to enable support.

0

FullScreenAlways

REG_DWORD

Indicates whether the RDP session runs in full-screen mode or windowed mode.

Set to 0 (zero) to run in windowed mode.

Set to 1 to run in full-screen mode. The user does not have the option to select a remote desktop size in the Remote Desktop Connection dialog box, on the Display tab.

In the Standard Shell, the default is 0.

In the Windows Thin Client Shell, the default is 1.

Redir0

REG_DWORD

Indicates whether smart cards are automatically redirected when the user logs onto a remote server.

Set to 0 (zero) to disable smart card redirection. Set to 1 enable to smart card redirection.

1

Redir1

REG_DWORD

Indicates whether drives are automatically redirected when the user logs on to a remote server.

Set to 0 (zero) to disable drive redirection. Set to 1 enable drive redirection.

1

Redir2

REG_DWORD

Indicates whether serial ports are automatically redirected when the user logs on to a remote server.

Set to 0 (zero) to disable serial port redirection. Set to 1 to enable serial port redirection.

1

Redir3

REG_DWORD

Indicates whether printers are automatically redirected when the user logs on to a remote server.

Set to 0 (zero) to disable printer redirection. Set to 1 to enable printer redirection.

1

Redir4

REG_DWORD

Indicates whether audio playback is automatically redirected when the user logs on to a remote server.

Set to 0 (zero) to disable audio playback redirection. Set to 1 to enable audio playback redirection.

1

Redir5

REG_DWORD

Indicates whether the clipboard is automatically redirected when the user logs on to a remote server.

Set to 0 (zero) to disable clipboard redirection. Set to 1 to enable clipboard redirection.

1

Redir6

REG_DWORD

Indicates whether audio recording is automatically redirected when the user logs on to a remote server.

Set to 0 (zero) to disable audio recording redirection. Set to 1 to enable audio recording redirection.

1

RightMouseForALT

REG_DWORD

Indicates the effect of pressing the Alt key while clicking the left mouse button.

Set to 0 (zero) to send an Alt plus left mouse click to the server when the user presses the Alt key.

Set to 1 to send a right mouse click to the server when the user presses the Alt key.

1

Static Virtual Channel Plug-in

The Terminal Server Client loads the static virtual channel plug-in DLLs by using these registry entries, located in the key HKEY_LOCAL_MACHINE\Software\Microsoft\Terminal Server Client\Default\Addins\<static virtual channel name>.

Name Type Description Default value

Name

REG_SZ

The name of the static virtual channel plug-in DLLs to load. Separate DLL names with a comma (,).

None

Security Provider

When you include SYSGEN_AUTH_NTLM in a run-time image, you can ensure that the Negotiate security package selects the Windows NT LAN Manager (NTLM) Security Support Provider (SSP) instead of Kerberos as the security provider. NTLM SSP prevents a 15-second delay during authentication over an RDP connection to a computer running Windows Vista. Use this registry entry, located in the key HKEY_LOCAL_MACHINE\Comm\SecurityProviders\Negotiate\Packages.

Name Type Description Default value

Packages

REG_SZ

Specifies the order of security providers that Simple and Protected GSS-API Negotiation (Negotiate SSP) chooses, as a comma-separated string.

Set to "NTLM" so that Negotiate SSP selects NTLM first.

None

See Also

Reference

Remote Desktop Connection Reference

Other Resources

Remote Desktop Connection