Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

To enable continuous provisioning, MSPROV DTD introduces new attributes to the parmelement defined in the OMA Client Provisioning specification. It also provides additional "query" and "remove" functionality. MSPROV DTD describes the Provisioning XML File, the document that is passed between the provisioning source and the device.

MSPROV DTD uses the following elements:

Element Description

characteristic Element

Allows you to group settings.

characteristic-error Element

Indicates that an error occurred while a characteristicelement in the XML document is processing. When an error occurs, the erroneous element is changed to a characteristic-errorelement.

characteristic-query Element

Queries the setting values designated by the characteristic type attributes.

characteristic-query-error Element

Indicates that an error occurred while a characteristic-queryelement from the XML document was processed. When an error occurs, the erroneous element is changed to a characteristic-query-errorelement.

nocharacteristic Element

In a request message, indicates the settings to be removed. In a response message, indicates the elements that do not exist.

nocharacteristic-error Element

Indicates that an error occurred while a nocharacteristicelement was processed. When an error occurs, the erroneous element is changed to a nocharacteristic-errorelement.

noparm Element

In a request message, this element indicates the setting to be removed. In a response message, this element indicates that the corresponding parm identified by the name attribute does not exist.

noparm-error Element

If an error occurs while a noparmelement is processing, the erroneous element will be changed to a noparm-errorelement.

parm Element

This element contains metadata that describes how that data is to be viewed and edited by the Configuration Service Provider.

parm-error Element

If an error occurs while a parmelement is processing, the erroneous element will be changed to a parm-errorelement.

parm-query Element

specifies a request for the current value of the setting designated by the name attribute.

parm-query-error Element

If an error occurs while a parm-queryelement is being processed, the erroneous element will be changed to a parm-query-errorelement.

Remarks

For the majority of XML documents, the most common node types are element, attribute, and text. Attributes occupy a special place in the model because they are not considered child nodes of a parent and are treated more like properties of elements.

When all settings in one characteristic are processed in the same manner, you can use the following elements:

  • characteristic

  • nocharacteristic

  • characteristic-query

The following list shows the setting elements that are nested below the characteristic element

  • parm

  • noparm

  • parm-query

At present, sending the parm-query and characteristic-query elements over the air is not supported due to the lack of an over-the-air (OTA) response mechanism.

Each Configuration Service Provider lists the Microsoft custom elements that it supports. To gain a broader understanding of how to use the Microsoft custom elements, see the OMA Client Provisioning examples for the various Configuration Service Providers. For more information, see Configuration Service Provider Reference for Windows Mobile Devices.

See Also