ConfigurationManager.ProcessConfiguration Method

Windows Mobile 6.5

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



The configuration document used to provision the device.


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);

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