ConfigurationManager.TestConfiguration Method


Sends a device configuration file to Configuration Manager for testing.

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


public static XmlDocument TestConfiguration (
    XmlDocument configDoc,
    bool metadata
Public Shared Function TestConfiguration ( _
    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.


Configuration Manager will not process the configuration file, but it can still return useful metadata associated with the XML parm elements.

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

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