Mobile​Broadband​Account​Watcher Mobile​Broadband​Account​Watcher Mobile​Broadband​Account​Watcher Class

Definition

Provides information regarding availability of and updates to Mobile Broadband Accounts.

Note

This functionality is only available to mobile operator apps and Windows Store app given privileged access by mobile network operators.

For permission to use this API, please reach out to Network Operators API Permissions.

For technical help with this API, please reach out to Network Operators API Help

public : sealed class MobileBroadbandAccountWatcher : IMobileBroadbandAccountWatcherpublic sealed class MobileBroadbandAccountWatcher : IMobileBroadbandAccountWatcherPublic NotInheritable Class MobileBroadbandAccountWatcher Implements IMobileBroadbandAccountWatcher
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Constructors

MobileBroadbandAccountWatcher() MobileBroadbandAccountWatcher() MobileBroadbandAccountWatcher()

Creates a new instance of a MobileBroadbandAccountWatcher.

Note

This functionality is only available to mobile operator apps and Windows Store app given privileged access by mobile network operators.

For permission to use this API, please reach out to Network Operators API Permissions.

For technical help with this API, please reach out to Network Operators API Help

public : MobileBroadbandAccountWatcher()public MobileBroadbandAccountWatcher()Public Sub New()
Attributes

Remarks

To enable the MobileBroadbandAccountWatcher, call the Start method.

Properties

Status Status Status

Gets the status of the account watcher.

Note

This functionality is only available to mobile operator apps and Windows Store app given privileged access by mobile network operators.

For permission to use this API, please reach out to Network Operators API Permissions.

For technical help with this API, please reach out to Network Operators API Help

public : MobileBroadbandAccountWatcherStatus Status { get; }public MobileBroadbandAccountWatcherStatus Status { get; }Public ReadOnly Property Status As MobileBroadbandAccountWatcherStatus
Attributes

Methods

Start() Start() Start()

Starts the account watcher.

Note

This functionality is only available to mobile operator apps and Windows Store app given privileged access by mobile network operators.

For permission to use this API, please reach out to Network Operators API Permissions.

For technical help with this API, please reach out to Network Operators API Help

public : void Start()public void Start()Public Function Start() As void
Attributes

Remarks

When you start the account watcher, it first enumerates all Mobile Broadband Accounts and raises an AccountAdded event for each account found. When the enumeration operation is completed, the account watcher raises the EnumerationCompleted event. After the EnumerationCompleted event is raised, the account watcher continues to raise account-related events (AccountAdded, AccountUpdated, and AccountRemoved ) until you call the Stop method.

Note that you do not need to explicitly stop and start the account watcher on App Suspend/Resume events. Instead, starting and starting the watcher is handled by the API itself.

Stop() Stop() Stop()

Stops the account watcher.

Note

This functionality is only available to mobile operator apps and Windows Store app given privileged access by mobile network operators.

For permission to use this API, please reach out to Network Operators API Permissions.

For technical help with this API, please reach out to Network Operators API Help

public : void Stop()public void Stop()Public Function Stop() As void
Attributes

Remarks

You can begin the process of stopping a MobileBroadbandAccountWatcher by calling the Stop method. When the MobileBroadbandAccountWatcher fully stops, the Stopped event is raised. When the MobileBroadbandAccountWatcher has been stopped, it no longer raises account-related events.

You can query the status of a watcher using the Status property to determine if the watcher was aborted due to an unexpected internal error condition.

Note that you do not need to explicitly stop and start the account watcher on App Suspend/Resume events. Instead, starting and starting the watcher is handled by the API itself.

Events

AccountAdded AccountAdded AccountAdded

Occurs when a Mobile Broadband Account is added to the client.

Note

This functionality is only available to mobile operator apps and Windows Store app given privileged access by mobile network operators.

For permission to use this API, please reach out to Network Operators API Permissions.

For technical help with this API, please reach out to Network Operators API Help

public : event TypedEventHandler AccountAddedpublic event TypedEventHandler AccountAddedPublic Event AccountAdded
Attributes

Remarks

The network account id of the account is available in the event handler from the NetworkAccountId property.

AccountRemoved AccountRemoved AccountRemoved

Occurs when a Mobile Broadband Account is removed from the client.

Note

This functionality is only available to mobile operator apps and Windows Store app given privileged access by mobile network operators.

For permission to use this API, please reach out to Network Operators API Permissions.

For technical help with this API, please reach out to Network Operators API Help

public : event TypedEventHandler AccountRemovedpublic event TypedEventHandler AccountRemovedPublic Event AccountRemoved
Attributes

Remarks

The network account id of the account is available in the event handler from the NetworkAccountId property.

AccountUpdated AccountUpdated AccountUpdated

Occurs when a Mobile Broadband Account is updated on the client.

Note

This functionality is only available to mobile operator apps and Windows Store app given privileged access by mobile network operators.

For permission to use this API, please reach out to Network Operators API Permissions.

For technical help with this API, please reach out to Network Operators API Help

public : event TypedEventHandler AccountUpdatedpublic event TypedEventHandler AccountUpdatedPublic Event AccountUpdated
Attributes

Remarks

The network account id of the account is available in the event handler from the NetworkAccountId property.

The AccountUpdated event is triggered when any of the following properties change:

EnumerationCompleted EnumerationCompleted EnumerationCompleted

Occurs when the account watcher has finished enumerating accounts for the client.

Note

This functionality is only available to mobile operator apps and Windows Store app given privileged access by mobile network operators.

For permission to use this API, please reach out to Network Operators API Permissions.

For technical help with this API, please reach out to Network Operators API Help

public : event TypedEventHandler EnumerationCompletedpublic event TypedEventHandler EnumerationCompletedPublic Event EnumerationCompleted
Attributes

Remarks

When the watcher is started, it enumerates all existing accounts (raising an AccountAdded event for each account). You can use the EnumerationCompleted event to determine when the enumeration operation has finished. After that, all proceeding events are new.

Stopped Stopped Stopped

Occurs when the MobileBroadbandAccountWatcher has stopped.

Note

This functionality is only available to mobile operator apps and Windows Store app given privileged access by mobile network operators.

For permission to use this API, please reach out to Network Operators API Permissions.

For technical help with this API, please reach out to Network Operators API Help

public : event TypedEventHandler Stoppedpublic event TypedEventHandler StoppedPublic Event Stopped
Attributes

Remarks

You can begin the process of stopping a MobileBroadbandAccountWatcher by calling the Stop method. When the MobileBroadbandAccountWatcher fully stops, the Stopped event is raised.

You can query the status of a watcher using the Status property to determine if the watcher was aborted due to an unexpected internal error condition.