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 ACCESS 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>ACCESS</NodeName>
		<Path>./Vendor/MSFT</Path>
		<DFProperties>
			<AccessType>
				<Get />
			</AccessType>
			<DFFormat>
				<node />
			</DFFormat>
			<Occurrence>
				<One />
			</Occurrence>
			<Scope>
				<Permanent />
			</Scope>
			<MSFT:RWAccess>3</MSFT:RWAccess>
			<MSFT:MinValue></MSFT:MinValue>
			<MSFT:MaxValue></MSFT:MaxValue>
			<MSFT:MaxLength></MSFT:MaxLength>
			<Description>An ACCESS object defines both the
name of the destination network and sources that map to it (URLs,
port numbers, and network adaptors or dialup connections).

For example, you would use ACCESS to define a network ("The
Internet"), the means of getting there (one or more
GPRS/1xRTT/dialup connections), and URLs or port numbers that
should map to the network.

Connection Manager uses this information to determine which
path/resources to use when a client requests a network
connection.</Description>
		</DFProperties>
		<Node>
			<NodeName></NodeName>
			<DFProperties>
				<AccessType>
					<Add />
					<Get />
					<Delete />
				</AccessType>
				<DFFormat>
					<node />
				</DFFormat>
				<Occurrence>
					<ZeroOrMore />
				</Occurrence>
				<Scope>
					<Dynamic />
				</Scope>
				<MSFT:RWAccess>3</MSFT:RWAccess>
				<MSFT:MinValue></MSFT:MinValue>
				<MSFT:MaxValue></MSFT:MaxValue>
				<MSFT:MaxLength></MSFT:MaxLength>
				<Description>The value of this node should be
a network name.  An example would be "The%20Internet" (without the
quotes).

Need to specify all mandatory subnodes (fields whose occurrence is
at least 1). In particular (though each is optional), you must
specify one or more of ConRefs, Domains, or Ports that map to the
destination network.

The addition, update, and deletion of this sub-tree of nodes have
to be specified in a single atomic transaction.</Description>
			</DFProperties>
			<Node>
				<NodeName>ConRefs</NodeName>
				<DFProperties>
					<AccessType>
						<Add />
						<Get />
						<Delete />
					</AccessType>
					<DFFormat>
						<node />
					</DFFormat>
					<Occurrence>
						<ZeroOrOne />
					</Occurrence>
					<Scope>
						<Dynamic />
					</Scope>
					<MSFT:RWAccess>3</MSFT:RWAccess>
					<MSFT:MinValue></MSFT:MinValue>
					<MSFT:MaxValue></MSFT:MaxValue>
					<MSFT:MaxLength></MSFT:MaxLength>
					<Description>Contains a list of one or
more ConRefs (that is, names of network connections that should be
mapped to this destination network).

ConRef is synonymous with NapId (see: NAP).</Description>
				</DFProperties>
				<Node>
					<NodeName></NodeName>
					<DFProperties>
						<AccessType>
							<Add />
							<Get />
							<Delete />
						</AccessType>
						<DFFormat>
							<node />
						</DFFormat>
						<Occurrence>
							<OneOrMore />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
					 
<MSFT:RWAccess>3</MSFT:RWAccess>
						<MSFT:MinValue></MSFT:MinValue>
						<MSFT:MaxValue></MSFT:MaxValue>
					 
<MSFT:MaxLength></MSFT:MaxLength>
						<Description>The value of x should be
"ConRef0", "ConRef1", etc. (without the
quotes).</Description>
					</DFProperties>
					<Node>
						<NodeName>ConRef</NodeName>
						<DFProperties>
							<AccessType>
								<Add />
								<Get />
								<Replace />
							</AccessType>
							<DFFormat>
								<chr />
							</DFFormat>
							<Occurrence>
								<One />
							</Occurrence>
							<Scope>
								<Dynamic />
							</Scope>
						 
<MSFT:RWAccess>3</MSFT:RWAccess>
							<DFType>
								<MIME>text/plain</MIME>
							</DFType>
						 
<MSFT:MinValue></MSFT:MinValue>
						 
<MSFT:MaxValue></MSFT:MaxValue>
						 
<MSFT:MaxLength></MSFT:MaxLength>
							<Description>The value of this
field should be a network access point name (see: NAP).  An example
would be "My%20GPRS" (without the quotes).</Description>
						</DFProperties>
					</Node>
				</Node>
			</Node>
			<Node>
				<NodeName>Domains</NodeName>
				<DFProperties>
					<AccessType>
						<Add />
						<Get />
						<Delete />
					</AccessType>
					<DFFormat>
						<node />
					</DFFormat>
					<Occurrence>
						<ZeroOrOne />
					</Occurrence>
					<Scope>
						<Dynamic />
					</Scope>
					<MSFT:RWAccess>3</MSFT:RWAccess>
					<MSFT:MinValue></MSFT:MinValue>
					<MSFT:MaxValue></MSFT:MaxValue>
					<MSFT:MaxLength></MSFT:MaxLength>
					<Description>Contains a list of one or
more Domains (that is, URL patterns) that should be mapped to this
destination network.</Description>
				</DFProperties>
				<Node>
					<NodeName></NodeName>
					<DFProperties>
						<AccessType>
							<Add />
							<Get />
							<Delete />
						</AccessType>
						<DFFormat>
							<node />
						</DFFormat>
						<Occurrence>
							<OneOrMore />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
					 
<MSFT:RWAccess>3</MSFT:RWAccess>
						<MSFT:MinValue></MSFT:MinValue>
						<MSFT:MaxValue></MSFT:MaxValue>
					 
<MSFT:MaxLength></MSFT:MaxLength>
						<Description>The name of this node
must be composed of numeric characters only.  The value is used to
enforce the order of Domain and Port mappings.

E.G. Domains/0/ will take precedence over Ports/1/ when Connection
Manager attempts to map a URL or Port to a destination
network.</Description>
					</DFProperties>
					<Node>
						<NodeName>DomainName</NodeName>
						<DFProperties>
							<AccessType>
								<Add />
								<Get />
								<Replace />
							</AccessType>
							<DFFormat>
								<chr />
							</DFFormat>
							<Occurrence>
								<One />
							</Occurrence>
							<Scope>
								<Dynamic />
							</Scope>
						 
<MSFT:RWAccess>3</MSFT:RWAccess>
							<DFType>
								<MIME>text/plain</MIME>
							</DFType>
						 
<MSFT:MinValue></MSFT:MinValue>
						 
<MSFT:MaxValue></MSFT:MaxValue>
						 
<MSFT:MaxLength></MSFT:MaxLength>
							<Description>The value of this
field should be a URL pattern.  An example would be
"*://*.woodgrovebank.com/*" (without the
quotes).</Description>
						</DFProperties>
					</Node>
				</Node>
			</Node>
			<Node>
				<NodeName>Ports</NodeName>
				<DFProperties>
					<AccessType>
						<Add />
						<Get />
						<Delete />
					</AccessType>
					<DFFormat>
						<node />
					</DFFormat>
					<Occurrence>
						<ZeroOrOne />
					</Occurrence>
					<Scope>
						<Dynamic />
					</Scope>
					<MSFT:RWAccess>3</MSFT:RWAccess>
					<MSFT:MinValue></MSFT:MinValue>
					<MSFT:MaxValue></MSFT:MaxValue>
					<MSFT:MaxLength></MSFT:MaxLength>
					<Description>Contains a list of one or
more Port numbers that should be mapped to this destination
network.</Description>
				</DFProperties>
				<Node>
					<NodeName></NodeName>
					<DFProperties>
						<AccessType>
							<Add />
							<Get />
							<Delete />
						</AccessType>
						<DFFormat>
							<node />
						</DFFormat>
						<Occurrence>
							<OneOrMore />
						</Occurrence>
						<Scope>
							<Dynamic />
						</Scope>
					 
<MSFT:RWAccess>3</MSFT:RWAccess>
						<MSFT:MinValue></MSFT:MinValue>
						<MSFT:MaxValue></MSFT:MaxValue>
					 
<MSFT:MaxLength></MSFT:MaxLength>
						<Description>The name of this node
must be composed of numeric characters only.  The value is used to
enforce the order of Domain and Port mappings.

E.G. Domains/0/ will take precedence over Ports/1/ when Connection
Manager attempts to map a URL or Port to a destination
network.</Description>
					</DFProperties>
					<Node>
						<NodeName>PortNbr</NodeName>
						<DFProperties>
							<AccessType>
								<Add />
								<Get />
								<Replace />
							</AccessType>
							<DFFormat>
								<int />
							</DFFormat>
							<Occurrence>
								<One />
							</Occurrence>
							<Scope>
								<Dynamic />
							</Scope>
						 
<MSFT:RWAccess>3</MSFT:RWAccess>
							<DFType>
								<MIME>text/plain</MIME>
							</DFType>
						 
<MSFT:MinValue>0</MSFT:MinValue>
						 
<MSFT:MaxValue>65535</MSFT:MaxValue>
						 
<MSFT:MaxLength></MSFT:MaxLength>
							<Description>The value of this
field should be a port number.</Description>
						</DFProperties>
					</Node>
				</Node>
			</Node>
		</Node>
	</Node>
</MgmtTree>

See Also