MobileBroadbandAccountWatcher MobileBroadbandAccountWatcher MobileBroadbandAccountWatcher MobileBroadbandAccountWatcher Class

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

Syntax

Declaration

public sealed class MobileBroadbandAccountWatcherpublic sealed class MobileBroadbandAccountWatcherPublic NotInheritable Class MobileBroadbandAccountWatcherpublic sealed class MobileBroadbandAccountWatcher

Constructors summary

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

Properties summary

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

Methods summary

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

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

Events summary

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

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

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

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

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

Constructors

  • MobileBroadbandAccountWatcher()
    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 New()Public Sub New()public MobileBroadbandAccountWatcher()

    Remarks

    To enable the MobileBroadbandAccountWatcher, call the Start() method.

Properties

Methods

  • Start()
    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 voidpublic void Start()

    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.

  • Stop()
    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 voidpublic void Stop()

    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.

Events

  • AccountAdded
    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 AccountAddedpublic event TypedEventHandler AccountAdded

    Remarks

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

  • AccountRemoved
    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 AccountRemovedpublic event TypedEventHandler AccountRemoved

    Remarks

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

  • AccountUpdated
    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 AccountUpdatedpublic event TypedEventHandler AccountUpdated

    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
    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 EnumerationCompletedpublic event TypedEventHandler EnumerationCompleted

    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
    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 Stoppedpublic event TypedEventHandler Stopped

    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.

Device family

Windows 10 (introduced v10.0.10240.0)

API contract

Windows.Foundation.UniversalApiContract (introduced v1)

Attributes

Windows.Foundation.Metadata.ActivatableAttribute
Windows.Foundation.Metadata.ContractVersionAttribute
Windows.Foundation.Metadata.DualApiPartitionAttribute

Details

Assembly

Windows.Networking.NetworkOperators.dll