Configuring a Portable Navigation Device by using OMA Client-based XML
.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.")
10/16/2008
Applies to Windows Embedded NavReady
Configured connections and their settings are stored in an Open Mobile Alliance (OMA) XML provisioning file.
Configuration Tasks
To create and manage connection settings, you can create an application that modifies the provisioning XML file in order to perform the following tasks:
- Create network settings for Remote Access Service (RAS) connections through Bluetooth Dial-up Networking (DUN)
- Modify and delete existing network settings
To perform these configuration tasks, the application can provide a user interface (UI) that allows users to change these configured settings. For example, you might create a Control Panel application that enables users to configure settings. The application can call the DMProcessConfigXML function and specify an XML code example that specifies the new configuration settings.
This XML file is stored in the appropriate Configuration Service Provider used by Connection Manager.
To configure connections for a portable navigation device (PND)
Create an application that enables a user to configure the connections on a portable navigation device (PND).
For information about how to create a Control Panel application, see How to Implement a Control Panel Application.
In the application code, convert user input into XML that is targeted to a specific Configuration Service Provider.
For more information about the XML accepted by each Configuration Service Provider, see Configuration Service Providers for Connection Manager.
In the application code, call DMProcessConfigXML to modify the XML provisioning file and change the configuration settings.
Provisioning Code Sample
For an example of how to configure connection settings on a Windows Embedded NavReady powered device by using a provisioning XML file, see the code sample located at %_WINCEROOT%\PUBLIC\CONNMGR\SDK\SAMPLES.