ConfigurationManager.TestConfiguration Method

  • Article

3/29/2010

Sends a device configuration file to Configuration Manager for testing.

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

Syntax

public static XmlDocument TestConfiguration (
    XmlDocument configDoc,
    bool metadata
)

'Declaration
Public Shared Function TestConfiguration ( _
    configDoc As XmlDocument, _
    metadata As Boolean _
) As XmlDocument

Parameters

  • 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.

Remarks

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

Reference

ConfigurationManager Class
ConfigurationManager Members
Microsoft.WindowsMobile.Configuration Namespace