Locale

Article
12/15/2021

MBAE deprecation warning

Important

Starting in Windows 10, version 1803, the MBAE app experience is replaced by an MO UWP app. For more information about MO UWP apps, see UWP mobile broadband apps.

The Locale element specifies the locale of the service metadata package. A service metadata package can specify single or multiple locales. To use multiple locales, you must set the MultipleLocale element to true.

Usage

<Locale
  default = "xs:boolean">
  text
</Locale>

Attributes

Attribute	Type	Required	Description
default	xs:boolean	Yes	Must be true (1) or false (0). If the default attribute is set to true, the operating system uses this device metadata package as the default for the current locale of the computer.

Child elements

There are no child elements.

Parent elements

Element	Description
MetadataKey	The MetadataKey element specifies the attributes of the device metadata package. These include the following: The identifier for each hardware function supported by the device. The language-specific locale for the text strings within the package.

MetadataKey

The MetadataKey element specifies the attributes of the device metadata package. These include the following:

The identifier for each hardware function supported by the device.
The language-specific locale for the text strings within the package.

XSD

<xs:element name="Locale" type="tns:LocaleType" />

<xs:complexType name="LocaleType">
  <xs:simpleContent>
    <xs:extension base="xs:string">
      <xs:attribute name="default" type="xs:boolean" use="required" />
    </xs:extension>
  </xs:simpleContent>
</xs:complexType>

Remarks

The Locale element can be <Language>-<Region> (such as EN-US) or <Language> (such as EN). If the <Language> is set, the package applies to all <Language> locales. For example, EN applies to EN-US and EN-BR.
To specify the metadata package as the default for the current locale of the computer, set the default attribute to true (1).

Note Only one metadata package for a service should set the default attribute to true (1). Otherwise, the operating system randomly selects a metadata package for the service.
When the operating system selects a service metadata package to display, it uses the Locale element in the following way:
1. The operating system retrieves the system preferred language and region. This is typically configured during Windows Setup.
2. If the Locale element of a service metadata package matches the system preferred language and region, the operating system selects the package for the service and uses the icon and ServiceProvider value (from ServiceInfo.xml) that matches that language and region.
3. If the services metadata package does not have a Locale element that matches the system preferred language, the operating system will apply the language neutral icon and ServiceProvider value (from ServiceInfo.xml) that is stored in the root of the service metadata package.

The Locale element is required.