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 Locale 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>Locale</NodeName>
		<Path>./Vendor/MSFT</Path>
		<DFProperties>
			<AccessType>
				<Get />
			</AccessType>
			<DFFormat>
				<node />
			</DFFormat>
			<Occurrence>
				<One />
			</Occurrence>
			<Scope>
				<Permanent />
			</Scope>
			<Description></Description>
		</DFProperties>
		<Node>
			<NodeName>Locale</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<int />
				</DFFormat>
				<Occurrence>
					<ZeroOrOne />
				</Occurrence>
				<Scope>
					<Permanent />
				</Scope>


				<DFTitle>Locale:</DFTitle>
				<DFType>
					<MIME>text/plain</MIME>
				</DFType>
 
				<Description>Locale setting choice in
regional settings. Overrides the user's choice if any. The value
passed in must be the ISO 639 LCID.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>Language</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<int />
				</DFFormat>
				<Occurrence>
					<ZeroOrOne />
				</Occurrence>
				<Scope>
					<Permanent />
				</Scope>

				<DFTitle>Language:</DFTitle>
				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

				<Description>Current language of the UI
displayed on the device.This parm uses the ISO 639 language code
for values. For example, US English is 1033 (0x409), German is 1031
(0x407), and French is 1036 (0x40C). 
Note:The user must reboot for this change to take
effect.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_INEGCURR</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<int />
				</DFFormat>
				<Occurrence>
					<One />
				</Occurrence>
				<Scope>
					<Permanent />
				</Scope>


				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 
				<MSFT:MaxLength>3</MSFT:MaxLength>
				<Description>Negative currency
mode.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_SMONTHOUSANDSEP</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<chr />
				</DFFormat>
				<Occurrence>
					<One />
				</Occurrence>
				<Scope>
					<Permanent />
				</Scope>


				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>Character(s) used as the
monetary separator between groups of digits to the left of the
decimal.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_ICURRDIGITS</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<int />
				</DFFormat>
				<Occurrence>
					<One />
				</Occurrence>
				<Scope>
					<Permanent />
				</Scope>


				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 
				<MSFT:MaxLength>6</MSFT:MaxLength>
				<Description>Country/region code, based on
international phone codes, also referred to as IBM country/region
codes.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_SMONDECIMALSEP</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<chr />
				</DFFormat>
				<Occurrence>
					<One />
				</Occurrence>
				<Scope>
					<Permanent />
				</Scope>


				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>Character(s) used as the
monetary decimal separator.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_ICURRENCY</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<int />
				</DFFormat>
				<Occurrence>
					<One />
				</Occurrence>
				<Scope>
					<Permanent />
				</Scope>


				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 
				<MSFT:MaxLength>2</MSFT:MaxLength>
				<Description>
					Positive currency mode. The maximum number of
characters allowed for this string is 2. The following table lists
the possible values for this parm.
					0 ¤1.1
					1 1.1¤
					2 ¤ 1.1
					3 1.1 ¤
				</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>SPECIAL_SCURRENCY</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<chr />
				</DFFormat>
				<Occurrence>
					<ZeroOrOne />
				</Occurrence>
				<Scope>
					<Permanent />
				</Scope>


				<DFTitle>Currency symbol:</DFTitle>
				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>String used as the local
monetary symbol.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_INEGNUMBER</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<int />
				</DFFormat>
				<Occurrence>
					<One />
				</Occurrence>
				<Scope>
					<Permanent />
				</Scope>


				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>
					Negative number mode. Options listed in
following table
						0  (1.1)
						1  -1.1
						2  - 1.1
						3  1.1-
						4  1.1 -
				</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_STHOUSAND</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<chr />
				</DFFormat>
				<Occurrence>
					<One />
				</Occurrence>
				<Scope>
					<Permanent />
				</Scope>


				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>Character(s) used to separate
groups of digits to the left of the decimal.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_IDIGITS</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<int />
				</DFFormat>
				<Occurrence>
					<One />
				</Occurrence>
				<Scope>
					<Permanent />
				</Scope>


				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 
				<MSFT:MaxLength>3</MSFT:MaxLength>
				<Description>Number of fractional
digits.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_SDECIMAL</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<chr />
				</DFFormat>
				<Occurrence>
					<One />
				</Occurrence>
				<Scope>
					<Permanent />
				</Scope>


				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>Character(s) used as the decimal
separator.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_ICALENDARTYPE</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<int />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>Current calendar type. Possible
values are:
1 Gregorian (as in United States) 
2 Gregorian (English strings always) 
3 Era: Year of the Emperor (Japan) 
4 Era: Year based on the Chinese Calendar 
5 Tangun Era (Korea)</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_IMEASURE</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<int />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 
				<MSFT:MaxLength>2</MSFT:MaxLength>
				<Description>System of measurement. This
value is 0 if the metric system is used and 1 if the U.S. system is
used. The maximum number of characters allowed for this string is
2.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_IFIRSTDAYOFWEEK</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<int />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>Specification for the first day
in a week. The following table lists the possible values for this
parm. 
0 LOCALE_SDAYNAME1 
1 LOCALE_SDAYNAME2 
2 LOCALE_SDAYNAME3 
3 LOCALE_SDAYNAME4 
4 LOCALE_SDAYNAME5 
5 LOCALE_SDAYNAME6 
6 LOCALE_SDAYNAME7</Description>
			</DFProperties>
		</Node>
		<Node>
		 
<NodeName>LOCALE_IFIRSTWEEKOFYEAR</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<int />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>Specification for the first week
of the year. The following lists the possible values for this parm.
 
0 Week containing 1/1 is the first week of that year. 
1 First full week following 1/1 is the first week of that year. 
2 First week containing at least 4 days is the first week of that
year.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_IPAPERSIZE</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<int />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>
					Default paper size associated with the locale.
						1 DMPAPER_LETTER
						5 DMPAPER_LEGAL
						9 DMPAPER_A4
						12 DMPAPER_B4
						13 DMPAPER_B5
				</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_SLONGDATE</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<chr />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>Long date formatting string for
this locale. The string can consist of a combination of day, month,
and year format pictures defined in the Day, Month, Year, and Era
Format Pictures table in National Language Support Constants and
any string of characters enclosed in single quotes. Characters in
single quotes remain as given.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_SPOSITIVESIGN</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<chr />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>String value for the positive
sign.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_SSHORTDATE</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<chr />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>Short date formatting string for
this locale. The string can consist of a combination of day, month,
and year format pictures defined in Day, Month, Year, and Era
Format Pictures table in National Language Support
Constants.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_STIMEFORMAT</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<chr />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>Time formatting strings for this
locale. The string can consist of a combination of the hour,
minute, and second format pictures defined in the Hour, Minute, and
Second Format Pictures table in National Language Support
Constants.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_SYEARMONTH</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<chr />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>The Year/Month formatting string
for the locale. This string shows the proper format for a date
string that contains only the year and the
month.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_ITIME</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<int />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>Time format specification. The
maximum number of characters allowed for this string is 2. The
following table lists the possible values for this parm. 
0 AM / PM 12-hour format 
1 24-hour format</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_STIME</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<chr />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>Character(s) for the time
separator.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_S1159</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<chr />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>String for the AM
designator.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_S2359</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<chr />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>String for the PM
designator.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_SDATE</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<chr />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

	 

				<Description>Character(s) for the date
separator.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_SGROUPING</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<chr />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

				<Description>Sizes for each group of digits
to the left of the decimal. An explicit size is needed for each
group; semicolons separate sizes. If the last value is zero, the
preceding value is repeated. To group thousands, specify 3;0.
</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_SLIST</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<chr />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>
 
				<Description>Character(s) used to separate
list items. For example, a comma is used in many
locales.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_SNEGATIVESIGN</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<chr />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>

				<Description>String value for the negative
sign.</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_ILZERO</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<int />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>
  
				<Description>Specification for leading zeros
in decimal fields. The maximum number of characters allowed for
this string is 2. The following table lists the possible values for
this parm. 
0 No leading zeros 
1 Leading zeros</Description>
			</DFProperties>
		</Node>
		<Node>
			<NodeName>LOCALE_SMONGROUPING</NodeName>
			<DFProperties>
				<AccessType>
					<Get />
					<Replace />
				</AccessType>
				<DFFormat>
					<chr />
				</DFFormat>
				<Scope>
					<Permanent />
				</Scope>

				<DFType>
					<MIME>text/plain</MIME>
				</DFType>
  
				<Description>Sizes for each group of monetary
digits to the left of the decimal. An explicit size is needed for
each group; semicolons separate sizes. If the last value is zero,
the preceding value is repeated. To group thousands, specify
3;0.</Description>
			</DFProperties>
		</Node>
	</Node>
</MgmtTree>

See Also