Configuring the Windows Thin Client Shell
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/27/2008
Client software on a Windows Embedded CE powered thin client must be registered with the shell so that information about the software can be made available to the user. The Windows Thin Client Shell uses the Windows Embedded CE registry to obtain client information for all the connection software installed on the system. The shell does not manage unregistered software.
Client information is read as soon as the shell starts. Therefore, it cannot change dynamically. If new client software is installed on a thin client, the system must be reset before connections that must be based on that software can be created.
Shell Registry Key
The HKEY_LOCAL_MACHINE\Software\Microsoft\WBT\Shell registry key contains information that configures the Windows Thin Client Shell.
Note
We recommend that you do not change the default values for these registry settings without carefully examining the system environment. Adjusting registry parameters may adversely affect system performance.
The following table shows the named values. These values are optional.
| Value | Description |
|---|---|
ConnectionDefaultKey: REG_SZ |
This value specifies the connection key for the default connection. No default setting is provided. |
ConnectionDefaultType: REG_SZ |
This value specifies the connection type for the default connection. It must specify the name of the registered client entry. Do not confuse this value with the Type entry of a registered client. No default setting is provided. |
DisableConfigureTab: REG_DWORD |
This value indicates whether the Configure tab is present on Connection Manager. The following list shows the possible values:
The default setting is zero (0). |
EnableAutoConnect: REG_DWORD |
This value determines whether the shell starts the default connection automatically. The following list shows the possible values:
The default setting is zero (0). This value is optional. |
EndTaskWaitTime: REG_DWORD |
This value specifies how much time, in milliseconds, between the time that the user clicks the End button and the time that the shell prompts the user to Wait, End Task, or Cancel if the process has not ended. The default setting is 10,000 milliseconds. This value is optional. |
SetupExe: REG_SZ |
This value specifies the name of the Setup Properties Sheets executable file. The default setting is Wbtsetup.exe. |
SetupCmdLine: REG_SZ |
This value specifies the command-line parameters to pass to the program that is specified by SetupExe. No default setting is provided. This value is optional. |
TaskmanTitle: REG_SZ |
This value specifies the text to display in the title bar of Connection Manager. You must end the title bar name with the words "Connection Manager". The default setting is "Terminal Connection Manager". Although this value is optional, we recommend that you provide a meaningful value to avoid an unwanted default value. |
Keyboard shortcut values |
For information about named values related to keyboard shortcuts, see Configuring Keyboard Shortcuts in Thin Client. |
To configure the Windows Thin Client Shell
In Platform Builder, on the File menu, select Open, and then select File.
Set Files of Type to All Files.
Navigate to %_WINCEROOT%\PUBLIC\RDP\OAK\FILES.
Select rdp.reg file and click Open.
In rdp.reg, add a registry root key.
In the HKEY_LOCAL_MACHINE\Software\Microsoft\WBT\Shell registry key, add the named values that you want to add.
On the File menu, select Save rdp.reg.
During the build process, makeimg.exe processes all .reg files in the build directories to create a single file, Reginit.ini. Reginit.ini forms the basis for the system registry.
In This Section
- Add the TS CAL Maintenance Tool to the Thin Client
Describes how to add the Terminal Services client access license (TS CAL) maintenance tool to the Windows Thin Client Shell Control Panel.
- Configuring Screen Savers on a Thin Client
Describes how to configure information for screen savers on a thin client that includes the Windows Thin Client Shell.
- Configuring the Desktop Background on a Thin Client
Describes how to configure the desktop background, also known as wallpaper, for a thin client that includes the Windows Thin Client Shell.
- Configuring the Terminal Services Client
Describes how to configure the Terminal Services Client by editing the registry settings.
- Customizing a Screen Saver for a Thin Client
Describes how to create a custom screen saver for a thin client that includes the Windows Thin Client Shell.
- Customizing the Setup Wizard and Property Sheets for a Thin Client
Describes how to customize the setup wizard and property sheets for a thin client that includes the Windows Thin Client Shell.
Related Sections
- Customizing CETSC UI
Describes how to customize Windows Embedded CE Terminal Services Client (CETSC) user interface (UI), including how to customize UI text and how to add a custom property page.