Retrieving Provisioning Information (Windows CE 5.0)
The VAIL provides the configuration data store to manage access to provisioning (and other VAIL setting) information.
You do not need to use the data store, because you can manage provisioning information in any way you want, and you can initialize the VAIL using information retrieved from any source. However, the data store is a useful object for a common need.
The Telephony User Interface (TUI) application demonstrates the use of the data store with the VAIL.
The data store handles loading, saving, and providing access to setting information. You access the data store using the IVoIPConfigurationDataStore interface.
For example, instead of managing the loading (and saving) of information using a file, the network, the registry, and so on, you can allow the data store to initialize itself and then access information using a single method.
You can also automatically store saved settings to the registry when you finish using the data store.
To use the data store, initialize it by calling IVoIPConfigurationDataStore::Initialize. This loads saved settings that exist in the registry or are defined as default settings.
You can then update the data store in bulk with additional information by calling one of the following methods:
- IVoIPConfigurationDataStore::UpdateSettingsFromFile. Updates the information in the data store with settings in an XML file.
- IVoIPConfigurationDataStore::UpdateSettingsFromServer. Updates the information in the data store with settings retrieved from an LDAP-compliant server, like a Microsoft Active Directory server.
- IVoIPConfigurationDataStore::UpdateSettingsFromXML. Updates the information in the data store with settings from a string that contains XML.
For more information about the required XML or LDAP formats, see the above referenced API documentation, CONFIG_DATA_, and Configuration Data Store Example XML.
After you initialize the data store, you can retrieve settings by calling IVoIPConfigurationDataStore::ReadValue and specifying the CONFIG_DATA_ constant for the value you want to retrieve. For example, to retrieve the URL of the Exchange server, call ReadValue with the CONFIG_DATA_EXCHANGE_OWASERVER value.
You can also update a single setting manually by calling IVoIPConfigurationDataStore::WriteValue.
When you finish using the data store, or if you want to save current settings (including those set manually or from a file, LDAP server, or string) call IVoIPConfigurationDataStore::Uninitialize.
See Also
IP Phone Provisioning | Telephony User Interface (TUI)
Send Feedback on this topic to the authors