Locale Configuration Service Provider

  • Article

4/8/2010

Use the Locale Configuration Service Provider to configure regional settings on the device.

This Configuration Service Provider can be managed over both the OMA Client Provisioning and the OMA DM protocol.

Note

This Configuration Service Provider is not available on Windows Mobile Professional or Windows Mobile Classic.

Note

Access to this Configuration Service Provider is determined by security roles. Because OEMs and mobile operators can selectively disallow access, ask them about the availability of this Configuration Service Provider. For more information about roles, see Security Roles and Default Roles for Configuration Service Providers.

The following table shows the default settings. The default security role maps to each subnode unless specific permission is granted to the subnode.

Permissions

Read/Write

Roles allowed to query and update setting

Manager

AuthenticatedUser

The following image shows the management object used by OMA DM.

Bb737540.6b25a6cc-1e7e-47c7-adaa-c38e6a757367(en-us,MSDN.10).gif

The following image shows the Configuration Service Provider in tree format as used by OMA Client Provisioning.

Bb737540.db400ad1-a4a4-4859-a079-43e6ee728a2a(en-us,MSDN.10).gif

Characteristics

Only the root characteristic is available.

Parameters

  • Language
    This parm sets the 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.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    Integer

    Label

    Language:

    Roles allowed to query and update setting

    Manager

    Operator TPS

    AuthenticatedUser

  • Locale
    This parm sets the current locale of the device. The value passed in must be the ISO 639 LCID.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    Integer

    Label

    Locale:

  • LOCALE_ICALENDARTYPE
    Current calendar type. The following table lists the possible values.

    Value Description

    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)

  • LOCALE_ICURRDIGITS
    Number of fractional digits for the local monetary format. The maximum number of characters allowed for this string is 9.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    Integer

    Label

    Number of decimal places:

  • LOCALE_ICURRENCY
    Positive currency mode. The maximum number of characters allowed for this string is 2. The following table lists the possible values.

    Value Description

    0

    Prefix, no separation

    1

    Suffix, no separation

    2

    Prefix, 1-character separation

    3

    Suffix, 1-character separation

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    Integer

    Label

    Symbol position:

  • LOCALE_IDIGITS
    Number of fractional digits. The maximum number of characters allowed for this string is 3.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    Integer

    Label

    Number of decimal places:

  • LOCALE_IFIRSTDAYOFWEEK
    Specification for the first day in a week. The following table lists the possible values.

    Value Description

    0

    LOCALE_SDAYNAME1

    1

    LOCALE_SDAYNAME2

    2

    LOCALE_SDAYNAME3

    3

    LOCALE_SDAYNAME4

    4

    LOCALE_SDAYNAME5

    5

    LOCALE_SDAYNAME6

    6

    LOCALE_SDAYNAME7

  • LOCALE_IFIRSTWEEKOFYEAR
    Specification for the first week of the year. The following table lists the possible values.

    Value Description

    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.

  • LOCALE_ILZERO
    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.

    Value Description

    0

    No leading zeros

    1

    Leading zeros
  • LOCALE_IMEASURE
    System of measurement. This value is 0 if the metric system (Systéme International d'Unités, or S.I.) is used and 1 if the U.S. system is used. The maximum number of characters allowed for this string is 2.

  • LOCALE_INEGCURR
    Negative currency mode. The maximum number of characters allowed for this string is 3. The following table lists the possible values.

    Value Example

    0

    ($1.1)

    1

    0$1.1

    2

    $01.1

    3

    $1.10

    4

    (1.1$)

    5

    01.1$

    6

    1.10$

    7

    1.1$0

    8

    01.1 $ (space before $)

    9

    0$ 1.1 (space after $)

    10

    1.1 $0 (space before $)

    11

    $ 1.10 (Space after $)

    12

    $01.1 (space after $)

    13

    1.10 $ (space before $)

    14

    ($ 1.1) (space after $)

    15

    (1.1 $) (Space before $)

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    Integer

    Label

    Negative number format:

  • LOCALE_INEGNUMBER
    Negative number mode. The following table lists the possible values.

    Value Description

    0

    (1.1)

    1

    01.1

    2

    0 1.1

    3

    1.10

    4

    1.1 0

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    Integer

    Label

    Negative number format:
  • LOCALE_IPAPERSIZE
    Default paper size associated with the locale.

  • LOCALE_ITIME
    Time format specification. The maximum number of characters allowed for this string is 2. The following table lists the possible values.

    Value Description

    0

    AM / PM 12-hour format

    1

    24-hour format
  • LOCALE_S1159
    String for the AM designator.
  • LOCALE_S2359
    String for the PM designator.
  • LOCALE_SCURRENCY
    Character to identify currency. For example, $.
  • LOCALE_SDATE
    Character(s) for the date separator.

  • LOCALE_SDECIMAL
    Character(s) used as the decimal separator.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    String

    Label

    Decimal symbol:

    Roles allowed to query and update setting

    Manager

    AuthenticatedUser
  • LOCALE_SGROUPING
    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.
  • LOCALE_SLIST
    Character(s) used to separate list items. For example, a comma is used in many locales.

  • LOCALE_SLONGDATE
    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.

    The following list shows the supported formats:

    • dddd, MMMM dd, yyyy
    • MMMM dd, yyyy

  • LOCALE_SMONDECIMALSEP
    Character(s) used as the monetary decimal separator.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    String

    Label

    Decimal symbol:

    Roles allowed to query and update setting

    Manager

    AuthenticatedUser

    The only values that can be changed are Dot (.) and Comma(,).

  • LOCALE_SMONGROUPING
    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.

  • LOCALE_SMONTHOUSANDSEP
    Character(s) used as the monetary separator between groups of digits to the left of the decimal.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    String

    Label

    Digit grouping symbol:

    Roles allowed to query and update setting

    Manager

    AuthenticatedUser

    The only values that can be changed are Dot (.) and Comma(,).

  • LOCALE_SNEGATIVESIGN
    String value for the negative sign.
  • LOCALE_SPOSITIVESIGN
    String value for the positive sign.
  • LOCALE_SSHORTDATE
    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.

  • LOCALE_STHOUSAND
    Character(s) used to separate groups of digits to the left of the decimal.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    String

    Label

    Digit grouping symbol:
  • LOCALE_STIME
    Character(s) for the time separator.

  • LOCALE_STIMEFORMAT
    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.

    Note

    For Windows Mobile Standard, the Home screen does not display the seconds in HH:MM:SS.

  • LOCALE_SYEARMONTH
    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.

  • SPECIAL_SCURRENCY
    String used as the local monetary symbol.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    String

    Label

    Currency symbol:

Microsoft Custom Elements

The following table shows the Microsoft custom elements that this Configuration Service Provider supports for OMA Client Provisioning.

Elements Available

parm-query

Yes

noparm

No

nocharacteristic

No

characteristic-query

No

Use these elements to build standard OMA Client Provisioning configuration XML. For information about specific elements, see MSPROV DTD Elements. For examples of how to generally use the Microsoft custom elements, see OMA Client Provisioning XML File Examples.

For information about OMA Client Provisioning, see OMA Client Provisioning Files.

See Also

Tasks

Locale Configuration Service Provider Example

Reference

Locale Configuration Service Provider Example for OMA DM

Concepts

Configuration Service Provider Reference for Windows Mobile Devices