MBNProfileExt

The MBNProfileExt element is an extension of the earlier MBNProfile element. It identifies a Mobile Broadband profile with a richer set of options than the MBNProfile element.

There can be more than one MbnProfileExt element in a profile, describing profile settings for a particular set of operating conditions. Use the ProfileConditionedOn child element of MBNProfileExt to specify which operating conditions make a particular profile the active profile.

Element hierarchy

<MBNProfileExt>

Syntax

<MBNProfileExt>

  <!-- Child elements -->
  Name,
  Description?,
  ICONFilePath?,
  IsDefault,
  ProfileCreationType?,
  SubscriberID?,
  SimIccID,
  HomeProviderName?,
  AutoConnectOnInternet?,
  ConnectionMode?,
  Context?,
  DataRoamingPartners?,
  PurposeGroups?,
  ProfileConditionedOn?,
  IsProvisioningProfile?,
  ApnID?,
  AdminEnable?,
  AdminRoamControl?,
  IsExclusiveToOther?,
  IsLongStandingAdditionalPdpContextProfile?,
  MmsConfiguration?,
  any element in a non-schema namespace*

</MBNProfileExt>

Key

?   optional (zero or one)

*   optional (zero or more)

Attributes and Elements

Attributes

None.

Child Elements

Child Element Description
AdminEnable

Specifies whether the profile is enabled administratively.This is a new element for v4.

AdminRoamControl

Specifies whether the profile is administratively roam controlled. This element is new for v4. The value of this element is a roamControlType value. This is an optional element; if no value is specified, then AllRoamAllowed is the default.

ApnID

An APN ID associated with this profile.This element is new in v4, and it is optional.

AutoConnectOnInternet

Specifies whether the Mobile Broadband device will automatically connect to a network.

For more information, see the documentation for the v1 AutoConnectOnInternet element.

ConnectionMode

Specifies the auto connection setting to be used for a Mobile Broadband device.

For more information, see the documentation for the v1 ConnectionMode element.

Context

Specifies the parameters required to establish a data connection.

DataRoamingPartners

Specifies a list of preferred network providers when roaming.

For details, see the documentation for the v1 DataRoamingPartners element.

Description

A description of the profile.

HomeProviderName

The name of the home provider for the given SIM/Device. For more information, see the documentation for the v1 HomeProviderName element.

ICONFilePath

The path to the icon file for the connection. The operating system connection user interface displays the icon when a connection is made using this profile.

For more details on using this element, see the v1 documentation for ICONFilePath.

IsDefault

Specifies whether this profile is the default profile.

For more detail on this element, see the v1 documentation for IsDefault.

IsExclusiveToOther

Specifies that this profile is exclusive to other profiles of the same profile set(s).This element is new for v4.

IsLongStandingAdditionalPdpContextProfile

Specifies that this profile is a long-standing additional PDP context profile.If the value of this element is true, then IsAdditionalPdpContextProfile must also be set to true. This is a new element for v4.

IsProvisioningProfile

Specifies that this profile is to be used for provisioning only.Otherwise, the profile is not applicable, and cannot be used to activate a Packet Data Protocol (PDP) context. This element is new for v4.

If IsProvisioningProfile is true, IsDefault must be false, and ConnectionMode must be manual.

MmsConfiguration

Configuration information for Multimedia Messaging Service (MMS).

In addition to setting the configuration elements within this element, an MMS profile must have the following settings.

Name

The name of the profile. For more information, see the documentation for the v1 Name element.

ProfileConditionedOn

Specifies the conditions which must be satisfied for a profile to be applicable.

This element is new for v4. It enables you to specify multiple profiles that apply in different conditions, and for the proper profile to be used automatically when it is applicable. This element is optional. If you do not specify it, then the profile is always applicable with respect to the conditions listed.

ProfileCreationType (in MBNProfileExt)

Specifies the creator of the profile.

For more information about this element, see the documentation for the v1 ProfileCreationType element.

PurposeGroups

An optional list of groups of profiles, where each group includes profiles used for a common purpose.

This element is new for v4 of the schema.

One profile can be listed in multiple groups.

SimIccID

The SIM Identifcation number for GSM devices. For more details , see the documentation for the v1 SimIccID element.

SubscriberID

Identifies the unique identifier of the profile.

For a GSM network this should contain the IMSI (International Mobile Subscriber Identity) of the SIM and for CDMA devices it should contain the MIN (Mobile Identification Number) of the device.

For more information, see the documentation for the v1 SubscriberID element.

 

Parent Elements

This outermost (document) element may not be contained by any other elements.

Requirements

Requirement Value

Namespace

https://www.microsoft.com/networking/WWAN/profile/v4