Creating a New CETSC Property Page
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
Applies to Windows Embedded CE 6.0 R2 Update KB945975
This topic describes how to create a custom property page, also known as an auxiliary tab, and add it to the Windows Embedded CE Terminal Services Client (CETSC) user interface (UI).
You can have a maximum of 16 property pages in CETSC UI. This includes existing property pages, such as the General property page, and also custom property pages.
To create a new CETSC property page
Start Platform Builder.
Open cetscoem.cpp, located in %_WINCEROOT%\PUBLIC\RDP\OAK\CETSC.
In the Initialize function implementation, increment the puAuxTabNum parameter value to reflect the number of custom property pages to add to CETSC UI at run time.
In the SetTabDispArea function implementation, use the RECT structure in the rcTab parameter to set the display area for the custom property page.
In the GetAuxTabInfo function implementation, create a new member of the RDP_TAB_INFO array for the new property page, and fill in the member with information about the new page.
In cetscoem.cpp, define an OemProcXXX dialog routine for the property page. Create source code for the property page by using the template code in propaux1.h and propaux1.cpp, located in %_WINCEROOT%\PUBLIC\RDP\OAK\CETSC, as a guideline. In the source code, implement OemProcXXX.
If you add a UI element to a new 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.
In %_WINCEROOT%\PUBLIC\RDP\OAK\CETSC, in the Sources file, add the file names that contain the new source code to the SOURCES file list.
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.