MSPROV DTD Elements
To enable continuous provisioning, MSPROV DTD introduces new attributes to the parm element 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 characteristic element in the XML document is processing. When an error occurs, the erroneous element is changed to a characteristic-error element. |
| 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-query element from the XML document was processed. When an error occurs, the erroneous element is changed to a characteristic-query-error element. |
| 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 nocharacteristic element was processed. When an error occurs, the erroneous element is changed to a nocharacteristic-error element. |
| 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 noparm element is processing, the erroneous element will be changed to a noparm-error element. |
| 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 parm element is processing, the erroneous element will be changed to a parm-error element. |
| 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-query element is being processed, the erroneous element will be changed to a parm-query-error element. |
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-Based Devices.
See Also
OMA Client Provisioning XML File Examples | MSPROV DTD Format | Configuration Service Providers
Send Feedback on this topic to the authors