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 EMAIL2 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>EMAIL2</NodeName>
		<Path>./Vendor/MSFT</Path>
		<DFProperties>
			<AccessType>
				<Get />
			</AccessType>
			<DFFormat>
				<node />
			</DFFormat>
			<Occurrence>
				<One />
			</Occurrence>
			<Scope>
				<Permanent />
			</Scope>
			<MSFT:RWAccess>3</MSFT:RWAccess>
			<DFTitle>EMAIL2</DFTitle>
			<MSFT:MinValue></MSFT:MinValue>
			<MSFT:MaxValue></MSFT:MaxValue>
			<MSFT:MaxLength></MSFT:MaxLength>
			<Description>Root
characteristic</Description>
		</DFProperties>
		<Node>
			<NodeName></NodeName>
			<DFProperties>
				<AccessType>
					<Add />
					<Delete />
				</AccessType>
				<DFFormat>
					<node />
				</DFFormat>
				<Occurrence>
					<OneOr6 />
				</Occurrence>
				<Scope>
					<Dynamic />
				</Scope>
				<MSFT:RWAccess>3</MSFT:RWAccess>
				<DFTitle>The GUID property</DFTitle>
				<DFType>
					<MIME>GUID</MIME>
				</DFType>
				<MSFT:MinValue></MSFT:MinValue>
				<MSFT:MaxValue></MSFT:MaxValue>
				<MSFT:MaxLength></MSFT:MaxLength>
				<Description>This is unique and identifies a
particular account. Also, we can only have 6 additional email
accounts. So, depending on how many are already there on the
device, we can have from 1 to 6.</Description>
			</DFProperties>
			<Node>
				<NodeName>SERVICENAME</NodeName>
				<DFProperties>
					<AccessType>
						<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>32</MSFT:MaxLength>
					<Description>This is the account name.
It's limited to 32 characters.</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>SERVICETYPE</NodeName>
				<DFProperties>
					<AccessType>
						<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>This is the type of account.
Valid values are POP3/IMAP4.</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>INSERVER</NodeName>
				<DFProperties>
					<AccessType>
						<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>62</MSFT:MaxLength>
					<Description>The incoming server name and
port number. Limited to 62 chars. If the standard port number is
used, the port number isn't necessary to be specified in this node.
The value format is:
Server name:port number</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>OUTSERVER</NodeName>
				<DFProperties>
					<AccessType>
						<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>62</MSFT:MaxLength>
					<Description>The outcoming server name
and port number. Limited to 62 chars. The value format is:
Server name:port number
If the standard port number is used, the port number isn't
necessary to be specified in this node.</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>AUTHNAME</NodeName>
				<DFProperties>
					<AccessType>
						<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>255</MSFT:MaxLength>
					<Description>User Name for Incoming
server. Limited to 255 chars.</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>AUTHSECRET</NodeName>
				<DFProperties>
					<AccessType>
						<Get />
						<Delete />
						<Replace />
					</AccessType>
					<DFFormat>
						<chr />
					</DFFormat>
					<Occurrence>
						<ZeroOrOne />
					</Occurrence>
					<Scope>
						<Dynamic />
					</Scope>
					<MSFT:RWAccess>2</MSFT:RWAccess>
					<DFType>
						<MIME>text/password</MIME>
					</DFType>
					<MSFT:MinValue></MSFT:MinValue>
					<MSFT:MaxValue></MSFT:MaxValue>
				 
<MSFT:MaxLength>255</MSFT:MaxLength>
					<Description>Password. Limited to 255
chars.</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>DOMAIN</NodeName>
				<DFProperties>
					<AccessType>
						<Get />
						<Delete />
						<Replace />
					</AccessType>
					<DFFormat>
						<chr />
					</DFFormat>
					<Occurrence>
						<ZeroOrOne />
					</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>255</MSFT:MaxLength>
					<Description>Incoming server credentials
domain. Limited to 255 chars.</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>NAME</NodeName>
				<DFProperties>
					<AccessType>
						<Get />
						<Delete />
						<Replace />
					</AccessType>
					<DFFormat>
						<chr />
					</DFFormat>
					<Occurrence>
						<ZeroOrOne />
					</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>255</MSFT:MaxLength>
					<Description>User Display Name. Limited
to 255 chars</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>REPLYADDR</NodeName>
				<DFProperties>
					<AccessType>
						<Get />
						<Replace />
					</AccessType>
					<DFFormat>
						<chr />
					</DFFormat>
					<Occurrence>
						<One />
					</Occurrence>
					<Scope>
						<Dynamic />
					</Scope>
					<MSFT:RWAccess>3</MSFT:RWAccess>
					<DFType>
						<MIME>text/emailaddress</MIME>
					</DFType>
					<MSFT:MinValue></MSFT:MinValue>
					<MSFT:MaxValue></MSFT:MaxValue>
				 
<MSFT:MaxLength>255</MSFT:MaxLength>
					<Description>SMTP reply address of the
user. Limited to 255 chars.</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>SMTPALTENABLED</NodeName>
				<DFProperties>
					<AccessType>
						<Get />
						<Replace />
					</AccessType>
					<DFFormat>
						<bool />
					</DFFormat>
					<Occurrence>
						<ZeroOrOne />
					</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>This is a bool value that
specifies if we have separate SMTP credentials.
1 for true
0 for false (default)</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>SMTPALTAUTHNAME</NodeName>
				<DFProperties>
					<AccessType>
						<Get />
						<Delete />
						<Replace />
					</AccessType>
					<DFFormat>
						<chr />
					</DFFormat>
					<Occurrence>
						<ZeroOrOne />
					</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>255</MSFT:MaxLength>
					<Description>If SMTPALTENABLED is true,
then this will have the alternate User Name for SMTP. 255
chars.</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>SMTPALTPASSWORD</NodeName>
				<DFProperties>
					<AccessType>
						<Get />
						<Delete />
						<Replace />
					</AccessType>
					<DFFormat>
						<chr />
					</DFFormat>
					<Occurrence>
						<ZeroOrOne />
					</Occurrence>
					<Scope>
						<Dynamic />
					</Scope>
					<MSFT:RWAccess>2</MSFT:RWAccess>
					<DFType>
						<MIME>text/password</MIME>
					</DFType>
					<MSFT:MinValue></MSFT:MinValue>
					<MSFT:MaxValue></MSFT:MaxValue>
				 
<MSFT:MaxLength>255</MSFT:MaxLength>
					<Description>If SMTPALTENABLED is true,
then this will have the alternate password for SMTP. 255
chars.</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>SMTPALTDOMAIN</NodeName>
				<DFProperties>
					<AccessType>
						<Get />
						<Delete />
						<Replace />
					</AccessType>
					<DFFormat>
						<chr />
					</DFFormat>
					<Occurrence>
						<ZeroOrOne />
					</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>255</MSFT:MaxLength>
					<Description>If SMTPALTENABLED is true,
then this will have the alternate domain for SMTP. 255
chars.</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>CONNECTIONID</NodeName>
				<DFProperties>
					<AccessType>
						<Get />
						<Delete />
						<Replace />
					</AccessType>
					<DFFormat>
						<chr />
					</DFFormat>
					<Occurrence>
						<ZeroOrOne />
					</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>This is the GUID that can
specify the connection to use while connecting to the servers. If
not specified, the device will choose the best possible
one.</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>LINGER</NodeName>
				<DFProperties>
					<AccessType>
						<Get />
						<Replace />
					</AccessType>
					<DFFormat>
						<int />
					</DFFormat>
					<Occurrence>
						<ZeroOrOne />
					</Occurrence>
					<Scope>
						<Dynamic />
					</Scope>
					<MSFT:RWAccess>3</MSFT:RWAccess>
					<DFType>
						<MIME>text/plain</MIME>
					</DFType>
					<MSFT:MinValue></MSFT:MinValue>
					<MSFT:MaxValue>60</MSFT:MaxValue>
					<MSFT:MaxLength></MSFT:MaxLength>
					<Description>Specifies how frequently
Messaging performs scheduled send/receives. (Specified as the
length of time in minutes, between updates.)</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>KEEPMAX</NodeName>
				<DFProperties>
					<AccessType>
						<Get />
						<Replace />
					</AccessType>
					<DFFormat>
						<int />
					</DFFormat>
					<Occurrence>
						<ZeroOrOne />
					</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>Specifies the maximum size
for a message's attachment. (Attachments beyond this size will not
be downloaded but will remain on the server. The message itself
will be downloaded). This value can be set only for IMAP4
accounts.</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>DWNDAY</NodeName>
				<DFProperties>
					<AccessType>
						<Get />
						<Replace />
					</AccessType>
					<DFFormat>
						<int />
					</DFFormat>
					<Occurrence>
						<ZeroOrOne />
					</Occurrence>
					<Scope>
						<Dynamic />
					</Scope>
					<MSFT:RWAccess>3</MSFT:RWAccess>
					<DFType>
						<MIME>text/plain</MIME>
					</DFType>
					<MSFT:MinValue></MSFT:MinValue>
					<MSFT:MaxValue>99</MSFT:MaxValue>
					<MSFT:MaxLength></MSFT:MaxLength>
					<Description>Specifies how many days of
email to download. (number of days worth going back into the
past)</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>RETRIEVE</NodeName>
				<DFProperties>
					<AccessType>
						<Get />
						<Replace />
					</AccessType>
					<DFFormat>
						<int />
					</DFFormat>
					<Occurrence>
						<ZeroOrOne />
					</Occurrence>
					<Scope>
						<Dynamic />
					</Scope>
					<MSFT:RWAccess>3</MSFT:RWAccess>
					<DFType>
						<MIME>text/plain</MIME>
					</DFType>
					<MSFT:MinValue></MSFT:MinValue>
				 
<MSFT:MaxValue>1022976</MSFT:MaxValue>
					<MSFT:MaxLength></MSFT:MaxLength>
					<Description>Specifies the maximum
size(in bytes) for messages retrieved from the incoming email
server. Messages beyond this size will still be retrieved, but will
be truncated.</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>AUTHREQUIRED</NodeName>
				<DFProperties>
					<AccessType>
						<Get />
						<Replace />
					</AccessType>
					<DFFormat>
						<bool />
					</DFFormat>
					<Occurrence>
						<ZeroOrOne />
					</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>This will specify whether
the outgoing server must use authentication.
1 for TRUE
0 for FALSE(default). 
Note: If this is not specified then SMTP authentication will not be
done. Also, this is different from the SMTPALTENABLED. That is to
specify different set of credentials for SMTP.</Description>
				</DFProperties>
			</Node>
			<Node>
				<NodeName>TAGPROPS</NodeName>
				<DFProperties>
					<AccessType>
						<Get />
					</AccessType>
					<DFFormat>
						<node />
					</DFFormat>
					<Occurrence>
						<One />
					</Occurrence>
					<Scope>
						<Dynamic />
					</Scope>
					<MSFT:RWAccess>1</MSFT:RWAccess>
					<MSFT:MinValue></MSFT:MinValue>
					<MSFT:MaxValue></MSFT:MaxValue>
					<MSFT:MaxLength></MSFT:MaxLength>
					<Description>Specifies that stated
parameter element name attributes is nonstandard tag
properties.</Description>
				</DFProperties>
				<Node>
					<NodeName>8128000B</NodeName>
					<DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<bool />
						</DFFormat>
						<Occurrence>
							<ZeroOrOne />
						</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>Specify whether incoming
server must use an SSL connection.
1- Require SSL connection
0- Doesn't require SSL connection (default)</Description>
					</DFProperties>
				</Node>
				<Node>
					<NodeName>812C000B</NodeName>
					<DFProperties>
						<AccessType>
							<Get />
							<Replace />
						</AccessType>
						<DFFormat>
							<bool />
						</DFFormat>
						<Occurrence>
							<ZeroOrOne />
						</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>Specify whether outgoing
server must use an SSL connection.
1- Require SSL connection
0- Doesn't require SSL connection (default)</Description>
					</DFProperties>
				</Node>
			</Node>
		</Node>
	</Node>
</MgmtTree>

See Also