Share via

ConfigurationManager.ProcessConfiguration Method


Sends a device configuration XML file to Configuration Manager for processing.

Namespace: Microsoft.WindowsMobile.Configuration
Assembly: Microsoft.WindowsMobile.Configuration (in microsoft.windowsmobile.configuration.dll)


public static XmlDocument ProcessConfiguration (
    XmlDocument configDoc,
    bool metadata
Public Shared Function ProcessConfiguration ( _
    configDoc As XmlDocument, _
    metadata As Boolean _
) As XmlDocument


  • configDoc
    The configuration document used to provision the device.
  • metadata
    true to return metadata associated with the XML parm elements in the new configuration; otherwise, false. If false, then configDoc is returned.

Return Value

If metadata was not requested, ProcessConfiguration simply returns the original device configuration XML file - but if metadata was requested, then ProcessConfiguration returns the original device configuration XML file, but with additional XML markup that describes any processing errors.


When a failure occurs, and an XML document is returned, be sure to parse the XML document for errors.


This example shows how to call ProcessConfiguration to set a new Browser Favorite in Internet Explorer Mobile.

XmlDocument configDoc = new XmlDocument();
    "<characteristic type=\"BrowserFavorite\">"+
    "<characteristic type=\"Microsoft\">"+
    "<parm name=\"URL\" value=\"\"/>"+
ConfigurationManager.ProcessConfiguration(configDoc, false);

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread-safe. Any instance members are not guaranteed to be thread-safe.

See Also


ConfigurationManager Class
ConfigurationManager Members
Microsoft.WindowsMobile.Configuration Namespace