Modifying CETSC Property Page Elements (Windows Embedded CE 6.0)
1/6/2010
Applies to Windows Embedded CE 6.0 R2Update KB945975
This topic describes how to modify UI elements on an existing CETSC property page.
The following table shows the property pages that you can modify:
Tab name in CETSC UI | Property page name |
---|---|
Display tab |
Propdisplay |
Local Resources tab |
Proplocalres |
Programs tab |
Proprun |
Experience tab |
Propperf |
Advanced tab |
Propadv |
Because of security issues, modifications of the General property page are limited to deciding whether to show or hide the Connection Settings box, which contains the Save, Save As, and Open buttons for working with .rdp files. Consequently, source code for the General property page is not available for modification, and the ability to show or hide the Connection Settings box is controlled by a registry setting. For more information, see the procedure entitled To show the Connection Settings box on the General property page.
To modify UI elements on a CETSC property page
Start Platform Builder.
Open cetscoem.cpp, located in %_WINCEROOT%\PUBLIC\RDP\OAK\CETSC.
In the Initialize function implementation, in pdwOptions, make sure that the hide option for the property page is not set.
In the SetTabDispArea function implementation, use the RECT structure in the rcTab parameter to set the display area for the property page.
In the OemProcXXX dialog routine for the property page, apply your customizations.
Apply additional UI customizations to the source code in %_WINCEROOT%\PUBLIC\RDP\OAK\CETSC.
If you decided to add a new UI element to a property page to enable the user to change an RDP setting, you must update the settings store in Cetsc.exe. For more information, see Updating an RDP Setting from CETSC UI.
On the Build menu, choose Global Build Settings, and then make sure that both Copy Files to Release Directory After Build and Make Run-Time Image After Build are selected.
On the Build menu, choose Advanced Build Commands, and then choose Build and Sysgen.
After you complete these steps and re-build the run-time image, when cetsc.exe starts during run time, it will call the functions in cetscoem.dll and apply your customizations to the CETSC UI.
To show the Connection Settings box on the General property page
Open rdp.reg.
In the HKEY_LOCAL_MACHINE\Software\Microsoft\Terminal Server Client registry key, set DisableFileAccess to 0 to enable .rdp file access and show the Connection Settings box.
For devices that use the Windows Thin Client Shell, the default value is 1, which hides the Connection Settings box.
For devices that use the Windows Embedded CE Standard Shell, by default the registry value is not present. Therefore, this value is interpreted as 0, which shows the Connection Settings box.
After you complete these steps and re-build the run-time image, when cetsc.exe starts during run time, it will call the functions in cetscoem.dll and apply your customizations to the CETSC UI.