Managing Microsoft Custom Properties (OMA DM)

  • Article

Send Feedback

You can access Microsoft custom properties by using the following elements:

  • To set properties of newly created nodes, use the Meta element.
  • To query and update properties of existing nodes, use the Get and Replace commands over a LocURI element.

Setting a Microsoft custom property

To set a Microsoft custom property when creating a new node use the meta element. The format for setting a Microsoft custom property in the Meta element is:

     <namespace:property>value</namespace:property>

namespace is the namespace reference for Microsoft custom properties. The URI is https://schemas.microsoft.com/MobileDevice/DM. However, you should use msft as the namespace reference in place of the URI. You do this by associating msft with the URI in the SyncML element at the beginning of your XML provisioning document. This is illustrated in the following example.

<SyncML xmlns='SYNCML:SYNCML 1.1' xmlns:msft='https://schemas.microsoft.com/MobileDevice/DM'>

property is the name of the Microsoft custom property that is being accessed.

Value is the setting applied to the property.

In the following example the add command creates a new node. The AccessRole of the new node is specified in the Meta element. The namespace reference is "msft".

<Add>
 <CmdID>3</CmdID>
 <Item>
   <Meta>
      <Format xmlns="syncml:metinf">int</Format>
      <msft:AccessRole>64</msft:AccessRole>
   </Meta>
   <Target><LocURI>./Vendor/ABCCompany/Settings/A</LocURI></Target>
   <Data><!— actual data here --></Data>
 </Item>
</Add>

Querying or updating a Microsoft custom Property

You can query or update the properties of an existing node with the LocURI element. Use the following format.

     <LocURI>URI?prop=msft:property<LocURI>

Since the colon (:) is a reserved character you must use the escape code for colon (%3A)

In the following example a Get command is used to query a device for the current AccessRole setting for the LOCALE_IDIGITS parameter of the Locale Configuration Service Provider.

<Get>
  <CmdID>5</CmdID>
  <Item>
    <Target>
      <LocURI>./Vendor/MSFT/Locale/LOCALE_IDIGITS?prop=msft%3AAccessRole</LocURI>
    </Target>
  </Item>
</Get>

The following example shows the result that would be returned by the device in response to the query.

<Results>
   <MsgRef>1</MsgRef><CmdRef>5</CmdRef>
   <CmdID>6</CmdID>
   <Item>
      <Source>
        <LocURI>./Vendor/MSFT/Locale/LOCALE_IDIGITS?prop=msft%3AAccessRole</LocURI>
      </Source>
<Data>16</Data>
</Item>
</Results>

Remarks

The LocURI for accessing the Uninstall root node is case sensitive.

See Also

OMA Device Management Provisioning | OMA DM Standards and Extensions

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.