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 Wi-Fi Configuration Service Provider. Open Mobile Alliance Device Management (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>Wi-Fi</NodeName>
		<Path>./Vendor/MSFT</Path>
		<DFProperties>
			<AccessType>
				<Get />
			</AccessType>
			<DFFormat>
				<node />
			</DFFormat>
			<Occurrence>
				<One />
			</Occurrence>
			<Scope>
				<Permanent />
			</Scope>
			<Description></Description>
		</DFProperties>
		<Node>
			<NodeName>ad-hoc</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
				</AccessType>
				<DFFormat>
					<node />
				</DFFormat>
				<Occurrence>
					<One />
				</Occurrence>
				<Scope>
					<Permanent />
				</Scope>
				<Description>Wi-Fi network type (ad-hoc or
access-point)</Description>
			</DFProperties>
			<Node>
				<NodeName></NodeName>
				<DFProperties>
					<AccessType>
						<Add />
						<Get />
						<Delete />
					</AccessType>
					<DFFormat>
						<node />
					</DFFormat>
					<Occurrence>
						<ZeroOrMore />
					</Occurrence>
					<Scope>
						<Dynamic />
					</Scope>
					<Description>To provision correctly, Add
the network name you want, then Replace
						default values for EAPType, KeyIndex,
Authentication, etc
					</Description>
				</DFProperties>
				<Node>
					<NodeName>EAPType</NodeName>
					<DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<int />
						</DFFormat>
						<Occurrence>
							<One />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
						<DFTitle>EAP type:</DFTitle>
						<DFType>
							<MIME>text/plain</MIME>
						</DFType>
						<Description>The Wi-Fi network EAP
type (13 = SmartCard or Certificate; 25 = Protected
EAP)</Description>
					</DFProperties>
				</Node>
				<Node>
					<NodeName>KeyIndex</NodeName>
					<DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<int />
						</DFFormat>
						<Occurrence>
							<One />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
						<DFTitle>Key index:</DFTitle>
						<DFType>
							<MIME>text/plain</MIME>
						</DFType>
					 
<MSFT:MinValue>1</MSFT:MinValue>
					 
<MSFT:MaxValue>4</MSFT:MaxValue>
						<Description>The Wi-Fi network key
index</Description>
					</DFProperties>
				</Node>
				<Node>
					<NodeName>Authentication</NodeName>
					<DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<int />
						</DFFormat>
						<Occurrence>
							<One />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
					 
<DFTitle>Authentication:</DFTitle>
						<DFType>
							<MIME>text/plain</MIME>
						</DFType>
						<Description>The Wi-Fi authentication
method (0 = Open, 1 = Shared, 5 = WPA-NONE)</Description>
					</DFProperties>
				</Node>
				<Node>
					<NodeName>Encryption</NodeName>
					<DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<int />
						</DFFormat>
						<Occurrence>
							<One />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
						<DFTitle>Data
encryption:</DFTitle>
						<DFType>
							<MIME>text/plain</MIME>
						</DFType>
						<Description>The Wi-Fi network data
encryption standard (0 = WEP, 1 = None, 4 =
TKIP)</Description>
					</DFProperties>
				</Node>
				<Node>
					<NodeName>DestId</NodeName>
					<DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<chr />
						</DFFormat>
						<Occurrence>
							<One />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
						<DFTitle>Network
type:</DFTitle>
						<DFType>
							<MIME>text/plain</MIME>
						</DFType>
						<Description>Destination
Network</Description>
					</DFProperties>
				</Node>
				<Node>
					<NodeName>AdHoc</NodeName>
					<DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<bool />
						</DFFormat>
						<Occurrence>
							<One />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
						<DFTitle>This is a device to device
(ad-hoc) connection</DFTitle>
						<DFType>
							<MIME>text/plain</MIME>
						</DFType>
						<Description>Corresponds to the adhoc
checkbox in UI, but this should 
							not be used for provisioning. OEM's
should instead provision networks 
							under ./Vendor/MSFT/Wi-Fi/Access-Point
or ./Vendor/MSFT/Wi-Fi/Ad-Hoc to
							specify the network type.
						</Description>
					</DFProperties>
				</Node>
				<Node>
					<NodeName>KeyProvided</NodeName>
					<DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<bool />
						</DFFormat>
						<Occurrence>
							<One />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
						<DFTitle>The key is automatically
provided</DFTitle>
						<DFType>
							<MIME>text/plain</MIME>
						</DFType>
						<Description></Description>
					</DFProperties>
				</Node>
				<Node>
					<NodeName>Use8021x</NodeName>
					<DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<bool />
						</DFFormat>
						<Occurrence>
							<One />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
						<DFTitle>Use IEEE 802.1x network
access control</DFTitle>
						<DFType>
							<MIME>text/plain</MIME>
						</DFType>
						<Description></Description>
					</DFProperties>
				</Node>
				<Node>
					<NodeName>NetworkKey</NodeName>
				 <DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<chr />
						</DFFormat>
						<Occurrence>
							<One />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
						<DFTitle>Network key:</DFTitle>
						<DFType>
							<MIME>text/plain</MIME>
						</DFType>
					 
<MSFT:MaxLength>64</MSFT:MaxLength>
						<Description></Description>
					</DFProperties>
				</Node>
			</Node>
		</Node>
		<Node>
			<NodeName>access-point</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
				</AccessType>
				<DFFormat>
					<node />
				</DFFormat>
				<Occurrence>
					<One />
				</Occurrence>
				<Scope>
					<Permanent />
				</Scope>
				<Description>Wi-Fi network type (ad-hoc or
access-point)</Description>
			</DFProperties>
			<Node>
				<NodeName></NodeName>
				<DFProperties>
					<AccessType>
						<Add />
						<Get />
						<Delete />
					</AccessType>
					<DFFormat>
						<node />
					</DFFormat>
					<Occurrence>
						<ZeroOrMore />
					</Occurrence>
					<Scope>
						<Dynamic /> 
					</Scope>
					<Description>To provision correctly, Add
the network name you want, then Replace
				default values for EAPType, KeyIndex,
Authentication, etc </Description>
				</DFProperties>
				<Node>
					<NodeName>EAPType</NodeName>
					<DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<int />
						</DFFormat>
						<Occurrence>
							<One />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
						<DFTitle>EAP type:</DFTitle>
						<DFType>
							<MIME>text/plain</MIME>
						</DFType>
						<Description>The Wi-Fi network EAP
type (13 = SmartCard or Certificate; 25 = Protected
EAP)</Description>
					</DFProperties>
				</Node>
				<Node>
					<NodeName>KeyIndex</NodeName>
					<DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<int />
						</DFFormat>
						<Occurrence>
							<One />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
						<DFTitle>Key index:</DFTitle>
						<DFType>
							<MIME>text/plain</MIME>
						</DFType>
					 
<MSFT:MinValue>1</MSFT:MinValue>
					 
<MSFT:MaxValue>4</MSFT:MaxValue>
						<Description>The Wi-Fi network key
index</Description>
					</DFProperties>
				</Node>
				<Node>
					<NodeName>Authentication</NodeName>
					<DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<int />
						</DFFormat>
						<Occurrence>
							<One />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
					 
<DFTitle>Authentication:</DFTitle>
						<DFType>
							<MIME>text/plain</MIME>
						</DFType>
						<Description>The Wi-Fi authentication
method (0 = Open, 1 = Shared, 3 = WPA, 4 =
WPA-PSK)</Description>
					</DFProperties>
				</Node>
				<Node>
					<NodeName>Encryption</NodeName>
					<DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<int />
						</DFFormat>
						<Occurrence>
							<One />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
						<DFTitle>Data
encryption:</DFTitle>
						<DFType>
							<MIME>text/plain</MIME>
						</DFType>
						<Description>The Wi-Fi network data
encryption standard (0 = WEP, 1 = None, 4 =
TKIP)</Description>
					</DFProperties>
				</Node>
				<Node>
					<NodeName>DestId</NodeName>
					<DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<chr />
						</DFFormat>
						<Occurrence>
							<One />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
						<DFTitle>Network
type:</DFTitle>
						<DFType>
							<MIME>text/plain</MIME>
						</DFType>
						<Description>Destination
Network</Description>
					</DFProperties>
				</Node>
				<Node>
					<NodeName>AdHoc</NodeName>
					<DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<bool />
						</DFFormat>
						<Occurrence>
							<One />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
						<DFTitle>This is a device to device
(ad-hoc) connection</DFTitle>
						<DFType>
							<MIME>text/plain</MIME>
						</DFType>
						<Description>Corresponds to the adhoc
checkbox in UI, but this should 
							not be used for provisioning. OEM's
should instead provision networks 
							under ./Vendor/MSFT/Wi-Fi/Access-Point
or ./Vendor/MSFT/Wi-Fi/Ad-Hoc to
							specify the network type.
						</Description>
					</DFProperties>
				</Node>
				<Node>
					<NodeName>KeyProvided</NodeName>
					<DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<bool />
						</DFFormat>
						<Occurrence>
							<One />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
						<DFTitle>The key is automatically
provided</DFTitle>
						<DFType>
							<MIME>text/plain</MIME>
						</DFType>
						<Description></Description>
					</DFProperties>
				</Node>
				<Node>
					<NodeName>Use8021x</NodeName>
					<DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<bool />
						</DFFormat>
						<Occurrence>
							<One />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
						<DFTitle>Use IEEE 802.1x network
access control</DFTitle>
						<DFType>
							<MIME>text/plain</MIME>
						</DFType>
						<Description></Description>
					</DFProperties>
				</Node>
				<Node>
					<NodeName>NetworkKey</NodeName>
				 <DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<chr />
						</DFFormat>
						<Occurrence>
							<One />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
						<DFTitle>Network key:</DFTitle>
						<DFType>
							<MIME>text/plain</MIME>
						</DFType>
					 
<MSFT:MaxLength>64</MSFT:MaxLength>
						<Description></Description>
					</DFProperties>
				</Node>
			</Node>
		</Node>
		<Node>
			<NodeName>Filter</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<int />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>
				<DFType>
					<MIME>text/plain</MIME>
				</DFType>
				<MSFT:MinValue>0</MSFT:MinValue>
				<MSFT:MaxValue>2</MSFT:MaxValue>
				<Description>Specifies the networks that the
device should access. Other networks are ignored. Possible values
are “all”, “access-point”, and “ad-hoc”. Default value is
“all”.</Description>
			</DFProperties>
		</Node>
	</Node>
</MgmtTree>

See Also