RDP 6.0 Migration Issues (Windows Embedded CE 6.0)

1/6/2010

Applies to Windows Embedded CE 6.0 R2

This topic provides information on migration issues for developers using RDP 6.0.

Connecting to a Remote Server

The process to connect to a remove server to establish a Terminal Services session has changed from RDP 5.2 to RDP 6.0. For RDP 6.0, this process now involves interaction with CredUI and Network Level Authentication. And, to provide a higher level of security, the step that establishes a connection to the remote server has changed. This step is highlighted in both processes described as follows.

For more information about CredUI and Network Level Authentication, see RDP Security.

Ee484576.collapse(en-US,WinEmbedded.60).gifConnection Process in RDP 5.2

The following steps describe the process to connect in RDP 5.2:

  1. The user initiates an RDP connection to a remote server.
  2. A connection to the remote server is established.
  3. The server prompts the user for credentials.
  4. The user enters the credentials either by typing in the username and password, or by typing in a Smart Card PIN.
  5. The server authenticates the credentials.
  6. If the credentials are validated, the RDP session connection is completed.

Ee484576.collapse(en-US,WinEmbedded.60).gifConnection Process in RDP 6.0

The following steps describe the process to connect in RDP 6.0:

  1. The user initiates an RDP connection to a remote server.
  2. The RDP client calls CredUI.
  3. CredUI prompts the user for credentials.
  4. The user enters the credentials either by typing in the username and password, or by typing in a Smart Card PIN.
  5. CredUI sends the credentials to the remote server.
  6. The server authenticates the credentials and, if necessary, sends the credentials to the domain controller.
  7. If the credentials are validated, a connection to the remote server is established.

RDP Mode of Operation

With RDP 6.0, there is only one mode of operation: ActiveX Control mode. Windows mode is no longer supported. Therefore, the following extended APIs are no longer useful for creating a virtual channel based on RDP 6.0:

  • VirtualChannelCloseEx
  • VirtualChannelEntryEx
  • VirtualChannelInitEventEx
  • VirtualChannelInitEx
  • VirtualChannelOpenEventEx
  • VirtualChannelOpenEx
  • VirtualChannelWriteEx
  • CHANNEL_ENTRY_POINTS_EX

Remote Desktop Connection Client

An updated version of the Remote Desktop Connection client is available with RDP 6.0, and it also uses new settings in the .rdp file. The updated version of the Remote Desktop Connection client is automatically included with SYSGEN_RDP and SYSGEN_RDP_UI.

For more information, see Windows Embedded CE Terminal Services Client (CETSC) and Terminal Services Client Configuration through the .rdp File.

RDP Keywords

The following table shows the list of RDP keywords for RDP 6.0 in comparison to the list of RDP keywords for RDP 5.2.

Note

RDP keywords can be used in either the .rdp file or in the registry depending on the type of shell included in the OS design.

Previous RDP keyword (before RDP 5.2) RDP keyword in RDP 5.2 RDP keyword in RDP 6.0

Alternate Shell

AlternateShell

Alternate Shell

AudioMode

AudioRedirectionMode

AudioMode

AutoLogon

None

No longer supported

Autoreconnection Enabled

AutoreconnectEnabled

Autoreconnection Enabled

BitmapCachePersistEnable

BitmapPersistenceEnabled

BitmapCachePersistEnable

BitmapPersistCache16Size

None. Use BitmapCacheSize.

BitmapCacheSize

BitmapPersistCache24Size

None. Use BitmapCacheSize.

BitmapCacheSize

BitmapPersistCacheSize

None. Use BitmapCacheSize.

BitmapCacheSize

BitmapPersistence

BitmapPersistCacheLocation

BitmapPersistCacheLocation

Compression

Compress

Compression

Connect to console

ConnectToServerConsole

Connect to console

Disable CTRL+ALT+DEL

None.

None.

Disable Cursor setting

None.

None.

DisplayConnectionBar

BBarEnabled

DisplayConnectionBar

None

BbarShowPinButton

None.

Full Address

ServerName

No longer supported

FullScreen

StartFullScreen

None. Use Screen Mode ID.

KeyboardHook

KeyboardHookMode

KeyboardHook

MRU0

None

No longer supported.

None

BBarPinned

None.

None

BBarShowMinimizeBtn

None.

None

BBarShowRestoreBtn

None.

Password 51

Password

No longer supported.

PluginLists

None.

None.

RedirectCOMPorts

EnablePortRedirection

RedirectCOMPorts

RedirectDrives

EnableDriveRedirection

RedirectDrives

RedirectPrinters

EnablePrinterRedirection

RedirectPrinters

RedirectSmartCards

EnableSCardRedirection

RedirectSmartCards

Screen Mode ID

None. Use StartFullScreen.

Screen Mode ID

Server Port

MCSPort

Server Port

Session Bpp

ColorDepthID

Session Bpp

Shell Working Directory

WorkingDir

Shell Working Directory

See Also

Other Resources

RDP Migration