The ROMPackage Configuration Service Provider

6/2/2010

The ROMPackage Configuration Provider is a Microsoft extension of the OMA DM standard. It is the software component on the Windows Mobile device that an OMA DM server queries to determine which versions of ROM packages are installed on the device. This process allows the DM server to select the correct update package to offer to a device.

When a DM Server queries the device for information about a ROM package (identifier, version, and state), the ROMPackage Configuration Service Provider returns a ROMPackage object containing this information. ROMPackage objects are positioned below the MSFT vendor node (./vendor/MSFT/ROMPackage).

The MSFT node in the diagram below indicates where Microsoft extensions to the OMA DM standard management object start. The following figure shows the structure of the ROMPackage management object:

ROMPackage Parameters

The following table shows the parameters for the ROMPackage management object.

• ROMPackage
  This is the root node of the ROMPackage object. This contains a list of all packages that are currently installed on the device. The server uses this information to determine the updates that apply to the device.

  The default security role maps to each sub-node unless specific permission is granted to the sub-node.

• ROMPackage/x
  X is the ROM package identifier (a GUID).

• ROMPackage/x/PkgName
  This is the name of the package currently installed on the device. It is optional.

• ROMPackage/x/PkgVersion
  Contains version information for the ROM package.

• ROMPackage/x/State
  Indicates the state of the package.

  The value of 80 (Update successful; update complete; data is still available.) is always returned.

Code Example

Description

This example shows how an XML file is structured to send a query to the ROMPackage Configuration Service Provider.

Code

<Get>
 <CmdID>1</CmdID>
  <Item>
   <Target>
    <LocURI>./Vendor/MSFT/ROMPackage?list=StructData</LocURI>
   </Target>
 </Item>
</Get>