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:
- The user initiates an RDP connection to a remote server.
- A connection to the remote server is established.
- The server prompts the user for credentials.
- The user enters the credentials either by typing in the username and password, or by typing in a Smart Card PIN.
- The server authenticates the credentials.
- 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:
- The user initiates an RDP connection to a remote server.
- The RDP client calls CredUI.
- CredUI prompts the user for credentials.
- The user enters the credentials either by typing in the username and password, or by typing in a Smart Card PIN.
- CredUI sends the credentials to the remote server.
- The server authenticates the credentials and, if necessary, sends the credentials to the domain controller.
- 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 |