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.

Connection 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.

Connection 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