TUISettings (Windows CE 5.0)
TUISettings provides access to configuration information stored in the registry that CVoIPApp does not provide. Developers can use TUISettings to retrieve or set a TUI configuration setting (that is stored in the registry) with a single line of code.
This class is defined in %_WINCEROOT%\Public\VoIP\OAK\Phone\TUI\App\Settings.cpp (and Settings.h).
Configuration Data in TUISettings
TUISettings exposes a number of static methods that represent various configuration data for TUI, like the type of filters the user uses when viewing contacts. For a complete list of settings, see TUISettings.h or TUI Registry Settings.
A number of settings that TUI uses are not stored by TUISettings and are instead provided by the global VAIL IVoIPConfigurationDataStore instance. These settings include SIP connection information and Exchange server connection information.
Although the ultimate repository for most configuration data is the IVoIPConfigurationDataStore instance, TUISettings maintains local cached copies of some VAIL configuration data for performance reasons. It uses the CMirroredStrSetting class, explained below, to do this.
Because TUISettings exposes only static methods, application code accesses its information without creating an instance.
For more information about TUI registry settings, see TUI Registry Settings. For more information about VAIL registry settings, including those provided by IVoIPConfigurationDataStore, see VAIL Registry Settings.
Utility Classes Used by TUISettings
Settings.cpp contains implementations of classes that represent configuration data in a small class hierarchy. This hierarchy is rooted in the CSetting class, which has these children:
- CIntSetting. Stores integers. A child of CSetting.
- CMirroredStrSetting. Stores a local copy of a VAIL string setting returned by the global IVoIPConfigurationDataStore instance, for quicker access to this setting. A child of CStrSetting.
- CMyURISetting. Stores the phone's URI and updates internal settings when the URI changes. A child of CMirroredStrSetting.
- CProtectedStrSetting. Stores the string using the Windows CE Credential Manager, not in the registry. A child of CStrSetting. For more information about the Credential Manager, see Credential Manager.
- CStrSetting. Stores strings. A child of CSetting.
- CVolumeSetting. Stores volume data corresponding to a specific hardware device, like the ringer, handset, or speaker (each an instance of the VoIPVolumeType enumeration). A child of CIntSetting.
See Also
Send Feedback on this topic to the authors