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 SoftwareDisable Configuration Service Provider. 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 file 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>SoftwareDisable</NodeName>
	<Path>./Vendor/MSFT</Path>
	<DFProperties>
	<AccessType>
		<Get />
	</AccessType>
	<Description>THe root node for software disable
management object.</Description>
	<DFFormat>
		<node />
	</DFFormat>
	<Occurrence>
		<One />
	</Occurrence>
	<Scope>
		<Permanent />
	</Scope>
	<DFType>
	 
<DDFName>com.microsoft/windowsMobile/1.0/SoftwareDisableMO</DDFName>
	</DFType>
	<MSFT:AccessRole>8</MSFT:AccessRole>
	<MSFT:RWAccess>1</MSFT:RWAccess>
	</DFProperties>
	<Node>
	<NodeName>DisabledSystemFiles</NodeName>
	<DFProperties>
		<AccessType>
		<Add />
		<Get />
		<Delete />
		</AccessType>
		<Description>Parent node used to group disabled
binary files in ROM.</Description>
		<DFFormat>
		<node />
		</DFFormat>
		<Occurrence>
		<ZeroOrOne />
		</Occurrence>
		<Scope>
		<Dynamic />
		</Scope>
		<DFType>
		<DDFName></DDFName>
		</DFType>
		<MSFT:RWAccess>3</MSFT:RWAccess>
	</DFProperties>
	<Node>
		<NodeName></NodeName>
		<DFProperties>
		<AccessType>
			<Add />
			<Get />
			<Delete />
			<Replace />
		</AccessType>
		<Description>The node for one single file disable
instance.  The node name is a string with file name of the binary
to be disabled.  The string needs to be unicoded, then UTF-8
encoded, then URI escaped. 
The node value if specified represents the user friendly name for
the disabled file.</Description>
		<DFFormat>
			<chr />
		</DFFormat>
		<Occurrence>
			<ZeroOrMore />
		</Occurrence>
		<Scope>
			<Dynamic />
		</Scope>
		<DFType>
			<MIME>text/plain</MIME>
		</DFType>
		<MSFT:RWAccess>3</MSFT:RWAccess>
		</DFProperties>
	</Node>
	</Node>
	<Node>
	<NodeName>EnabledInstalledFiles</NodeName>
	<DFProperties>
		<AccessType>
		<Add />
		<Get />
		<Delete />
		</AccessType>
		<Description>Parent node to group the enabled
installable binaries in RAM/persistent store.  These binaries must
be identified via the hash of the file.</Description>
		<DFFormat>
		<node />
		</DFFormat>
		<Occurrence>
		<ZeroOrOne />
		</Occurrence>
		<Scope>
		<Dynamic />
		</Scope>
		<DFType>
		<DDFName></DDFName>
		</DFType>
		<MSFT:RWAccess>3</MSFT:RWAccess>
	</DFProperties>
	<Node>
		<NodeName>SHA1</NodeName>
		<DFProperties>
		<AccessType>
			<Add />
			<Get />
			<Delete />
		</AccessType>
		<Description>Group the binary hashes that is
generated via SHA1 hash algorithm.</Description>
		<DFFormat>
			<node />
		</DFFormat>
		<Occurrence>
			<ZeroOrOne />
		</Occurrence>
		<Scope>
			<Dynamic />
		</Scope>
		<DFType>
			<DDFName></DDFName>
		</DFType>
		<MSFT:RWAccess>3</MSFT:RWAccess>
		</DFProperties>
		<Node>
		<NodeName></NodeName>
		<DFProperties>
			<AccessType>
			<Add />
			<Get />
			<Delete />
			<Replace />
			</AccessType>
			<Description>The node for one single file enable
instance.  The node name is URI-escaped B64 encoded SHA1 hash of
binary file (exclude the signature part of binary if the file is
signed.)</Description>
			<DFFormat>
			<node />
			</DFFormat>
			<Occurrence>
			<ZeroOrMore />
			</Occurrence>
			<Scope>
			<Dynamic />
			</Scope>
			<DFType>
			<DDFName></DDFName>
			</DFType>
			<MSFT:RWAccess>3</MSFT:RWAccess>
		</DFProperties>
		<Node>
			<NodeName>PrivilegeLevel</NodeName>
			<DFProperties>
			<AccessType>
				<Add />
				<Get />
				<Delete />
				<Replace />
			</AccessType>
			<Description>This node specifies whether to
allow app in allow-list to run as privileged or un-privileged. 
1 (default) - Normal
2 – trusted</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>FileName</NodeName>
			<DFProperties>
			<AccessType>
				<Add />
				<Get />
				<Delete />
				<Replace />
			</AccessType>
			<Description>The node to hold the application
name. Used by the server to track which app is
allow-listed.</Description>
			<DFFormat>
				<chr />
			</DFFormat>
			<Occurrence>
				<ZeroOrOne />
			</Occurrence>
			<Scope>
				<Dynamic />
			</Scope>
			<DFType>
				<MIME>text/plain</MIME>
			</DFType>
			<MSFT:RWAccess>3</MSFT:RWAccess>
			</DFProperties>
		</Node>
		</Node>
	</Node>
	</Node>
	<Node>
	<NodeName>NotificationString</NodeName>
	<DFProperties>
		<AccessType>
		<Add />
		<Get />
		<Delete />
		<Replace />
		</AccessType>
		<Description>String that will be shown when a process
attempts to access the In-ROM binary that is disabled.  This string
will not be localized.  If not specified, the default localized
string will be shown. 
%1 is reserved string that could be inserted in the string to
represent the disabled filename. The device will replace it with
real file name at runtime.
%2 is reserved string that could be  inserted in the string to
represent the friendly name of disabled file. 
The string length should be short enough to be fully shown in the
prompt dialog. If it is longer than allowed length, the additional
bytes will be truncated.</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>DisableNotification</NodeName>
	<DFProperties>
		<AccessType>
		<Add />
		<Get />
		<Delete />
		<Replace />
		</AccessType>
		<Description>This node, when set to true, will
disable the In-ROM application disable notification dialog. 
When set to false or missing, will enable the In-ROM application
disable notification dialog.</Description>
		<DFFormat>
		<bool />
		</DFFormat>
		<Occurrence>
		<ZeroOrOne />
		</Occurrence>
		<Scope>
		<Dynamic />
		</Scope>
		<DFType>
		<MIME>text/plain</MIME>
		</DFType>
		<MSFT:RWAccess>3</MSFT:RWAccess>
	</DFProperties>
	</Node>
  </Node>
</MgmtTree>

See Also