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

This topic shows the Device Description Framework (DDF) file for the Download Configuration Service Provider.

OMA DM DDF files and the example in this topic are used only for OMA DM provisioning. For more information, see OMA Device Management.

Note:
The first line of the DDF is the namespace reference for Microsoft custom properties. For more information, see Managing Microsoft Custom Properties (OMA DM).
Copy Code
<MgmtTree
xmlns:MSFT="http://schemas.microsoft.com/MobileDevice/DM">
  <VerDTD>1.2</VerDTD>
  <Node>
	<NodeName>Download</NodeName>
	<Path>./Vendor/MSFT/SwMgmt</Path>
	<DFProperties>
	<AccessType>
		<Get />
	</AccessType>
	<Description>The root node for software download
object.</Description>
	<DFFormat>
		<node />
	</DFFormat>
	<Occurrence>
		<One />
	</Occurrence>
	<Scope>
		<Permanent />
	</Scope>
	<DFType>
	 
<DDFName>com.microsoft/windowsmobile/1.0/swdownload</DDFName>
	</DFType>
	<MSFT:AccessRole>8</MSFT:AccessRole>
	<MSFT:RWAccess>1</MSFT:RWAccess>
	</DFProperties>
	<Node>
	<NodeName></NodeName>
	<DFProperties>
		<AccessType>
		<Add />
		<Get />
		<Delete />
		</AccessType>
		<Description>This node is a parent node of the
Download parameters for a download package.</Description>
		<DFFormat>
		<node />
		</DFFormat>
		<Occurrence>
		<ZeroOrMore />
		</Occurrence>
		<Scope>
		<Dynamic />
		</Scope>
		<DFType>
		<DDFName></DDFName>
		</DFType>
		<MSFT:RWAccess>3</MSFT:RWAccess>
	</DFProperties>
	<Node>
		<NodeName>PkgID</NodeName>
		<DFProperties>
		<AccessType>
			<Add />
			<Get />
			<Replace />
		</AccessType>
		<Description>This leaf node specifies the package
ID for a downloadable package.</Description>
		<DFFormat>
			<chr />
		</DFFormat>
		<Occurrence>
			<One />
		</Occurrence>
		<Scope>
			<Dynamic />
		</Scope>
		<DFType>
			<MIME>text/plain</MIME>
		</DFType>
		<MSFT:RWAccess>3</MSFT:RWAccess>
		</DFProperties>
	</Node>
	<Node>
		<NodeName>Name</NodeName>
		<DFProperties>
		<AccessType>
			<Add />
			<Get />
			<Replace />
		</AccessType>
		<Description>This leaf node specifies the human
readable name of download package.</Description>
		<DFFormat>
			<chr />
		</DFFormat>
		<Occurrence>
			<ZeroOrOne />
		</Occurrence>
		<Scope>
			<Dynamic />
		</Scope>
		<DFType>
			<MIME>text/plain</MIME>
		</DFType>
		<MSFT:RWAccess>3</MSFT:RWAccess>
		</DFProperties>
	</Node>
	<Node>
		<NodeName>PkgURL</NodeName>
		<DFProperties>
		<AccessType>
			<Add />
			<Get />
			<Replace />
		</AccessType>
		<Description>This leaf node specifies the URI of
download package.</Description>
		<DFFormat>
			<chr />
		</DFFormat>
		<Occurrence>
			<One />
		</Occurrence>
		<Scope>
			<Dynamic />
		</Scope>
		<DFType>
			<MIME>text/plain</MIME>
		</DFType>
		<MSFT:RWAccess>3</MSFT:RWAccess>
		</DFProperties>
	</Node>
	<Node>
		<NodeName>Status</NodeName>
		<DFProperties>
		<AccessType>
			<Get />
		</AccessType>
		<Description>This leaf node specifies the Status of
the download and install operation. This value is set by the
client. Valid values are: 10-Idle/Start. 20-Download failed.
30-Download progressing. 40-Download complete. 50-Install
progressing. 70- Install failed and package is deleted.
</Description>
		<DFFormat>
			<int />
		</DFFormat>
		<Occurrence>
			<One />
		</Occurrence>
		<Scope>
			<Dynamic />
		</Scope>
		<DFType>
			<MIME>text/plain</MIME>
		</DFType>
		<MSFT:RWAccess>3</MSFT:RWAccess>
		</DFProperties>
	</Node>
	<Node>
		<NodeName>PkgType</NodeName>
		<DFProperties>
		<AccessType>
			<Add />
			<Get />
			<Replace />
		</AccessType>
		<Description>This leaf node specifies the MIME type
of a deployed Deployment Component in the
device.</Description>
		<DFFormat>
			<chr />
		</DFFormat>
		<Occurrence>
			<ZeroOrOne />
		</Occurrence>
		<Scope>
			<Dynamic />
		</Scope>
		<DFType>
			<MIME>text/plain</MIME>
		</DFType>
		<MSFT:RWAccess>3</MSFT:RWAccess>
		</DFProperties>
	</Node>
	<Node>
		<NodeName>Operations</NodeName>
		<DFProperties>
		<AccessType>
			<Get />
		</AccessType>
		<Description>This node is a parent node that groups
the executable operations.</Description>
		<DFFormat>
			<node />
		</DFFormat>
		<Occurrence>
			<One />
		</Occurrence>
		<Scope>
			<Dynamic />
		</Scope>
		<DFType>
			<DDFName></DDFName>
		</DFType>
		<MSFT:RWAccess>3</MSFT:RWAccess>
		</DFProperties>
		<Node>
		<NodeName>DownloadInstall</NodeName>
		<DFProperties>
			<AccessType>
			<Exec />
			<Get />
			</AccessType>
			<Description>This node is used with Exec command
to start the Download operation and install and activate the
Deployment Component; to download the Deployment Component into the
device and install and activate it into Active
state.</Description>
			<DFFormat>
			<null />
			</DFFormat>
			<Occurrence>
			<One />
			</Occurrence>
			<Scope>
			<Dynamic />
			</Scope>
			<DFType>
			<MIME>text/plain</MIME>
			</DFType>
			<MSFT:RWAccess>3</MSFT:RWAccess>
		</DFProperties>
		</Node>
	</Node>
	<Node>
		<NodeName>Ext</NodeName>
		<DFProperties>
		<AccessType>
			<Add />
			<Get />
		</AccessType>
		<Description>This node is used to group the vendor
specific options.</Description>
		<DFFormat>
			<node />
		</DFFormat>
		<Occurrence>
			<ZeroOrOne />
		</Occurrence>
		<Scope>
			<Dynamic />
		</Scope>
		<DFType>
			<DDFName></DDFName>
		</DFType>
		<MSFT:RWAccess>3</MSFT:RWAccess>
		</DFProperties>
		<Node>
		<NodeName>Microsoft</NodeName>
		<DFProperties>
			<AccessType>
			<Add />
			<Get />
			</AccessType>
			<Description>This node is used to group Microsoft
specific options.</Description>
			<DFFormat>
			<node />
			</DFFormat>
			<Occurrence>
			<ZeroOrOne />
			</Occurrence>
			<Scope>
			<Dynamic />
			</Scope>
			<DFType>
			<DDFName></DDFName>
			</DFType>
			<MSFT:RWAccess>3</MSFT:RWAccess>
		</DFProperties>
		<Node>
			<NodeName>Description</NodeName>
			<DFProperties>
			<AccessType>
				<Add />
				<Get />
				<Replace />
			</AccessType>
			<Description>This node is used to specify the
additional information that the server wants to notify the user in
Software installation history UI.</Description>
			<DFFormat>
				<chr />
			</DFFormat>
			<Occurrence>
				<ZeroOrOne />
			</Occurrence>
			<Scope>
				<Dynamic />
			</Scope>
			<DFType>
				<MIME>text/plain</MIME>
			</DFType>
			<MSFT:RWAccess>3</MSFT:RWAccess>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>PkgSize</NodeName>
			<DFProperties>
			<AccessType>
				<Add />
				<Get />
				<Replace />
			</AccessType>
			<Description>This node is used to specify the
download package size in bytes.</Description>
			<DFFormat>
				<int />
			</DFFormat>
			<Occurrence>
				<ZeroOrOne />
			</Occurrence>
			<Scope>
				<Dynamic />
			</Scope>
			<DFType>
				<MIME>text/plain</MIME>
			</DFType>
			 <MSFT:RWAccess>3</MSFT:RWAccess>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>NotUserRemovable</NodeName>
			<DFProperties>
			<AccessType>
				<Add />
				<Get />
				<Replace />
			</AccessType>
			<Description>This node is used to specify
whether to show the installed application in the Remove Program
control panel. 
Valid values:
False (default) - the installed application will show in the Remove
Program control panel depending on whether the user has correct
security role required for processing the cab (cab's security role
is decided by the signature of cab file).
True - the application will not be shown in the Remove Program
Control Panel.</Description>
			<DFFormat>
				<bool />
			</DFFormat>
			<Occurrence>
				<ZeroOrOne />
			</Occurrence>
			<Scope>
				<Dynamic />
			</Scope>
			<DFType>
				<MIME>text/plain</MIME>
			</DFType>
			<MSFT:RWAccess>3</MSFT:RWAccess>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>InstallOptions</NodeName>
			<DFProperties>
			<AccessType>
				<Add />
				<Get />
				<Replace />
			</AccessType>
			<Description>This node is used to specify the
installation options. Valid values: Silent – This is the default
value. Download and installation progress UI are suppressed.
However, UI displayed by the cab’s setup.dll is not
affected.</Description>
			<DFFormat>
				<chr />
			</DFFormat>
			<Occurrence>
				<One />
			</Occurrence>
			<Scope>
				<Dynamic />
			</Scope>
			<DFType>
				<MIME>text/plain</MIME>
			</DFType>
			<MSFT:RWAccess>3</MSFT:RWAccess>
			</DFProperties>
		</Node>
		</Node>
	</Node>
	</Node>
  </Node>
</MgmtTree>

See Also