MobileBroadbandAccountWatcher MobileBroadbandAccountWatcher MobileBroadbandAccountWatcher MobileBroadbandAccountWatcher Class

Creates a new instance of a MobileBroadbandAccountWatcher.

public : MobileBroadbandAccountWatcher()public MobileBroadbandAccountWatcher()Public Sub New()// You can use this method in JavaScript.

Remarks

To enable the MobileBroadbandAccountWatcher, call the Start method.

Gets the status of the account watcher.

public : MobileBroadbandAccountWatcherStatus Status { get; }public MobileBroadbandAccountWatcherStatus Status { get; }Public ReadOnly Property Status As MobileBroadbandAccountWatcherStatus// You can use this property in JavaScript.

Starts the account watcher.

public : void Start()public void Start()Public Function Start() As void// You can use this method in JavaScript.

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.

Stops the account watcher.

public : void Stop()public void Stop()Public Function Stop() As void// You can use this method in JavaScript.

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.

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

public : event TypedEventHandler AccountAdded<MobileBroadbandAccountWatcher,  MobileBroadbandAccountEventArgs>public event TypedEventHandler AccountAdded<MobileBroadbandAccountWatcher,  MobileBroadbandAccountEventArgs>Public Event AccountAdded<MobileBroadbandAccountWatcher,  MobileBroadbandAccountEventArgs>// You can use this event in JavaScript.

Remarks

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

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

public : event TypedEventHandler AccountRemoved<MobileBroadbandAccountWatcher,  MobileBroadbandAccountEventArgs>public event TypedEventHandler AccountRemoved<MobileBroadbandAccountWatcher,  MobileBroadbandAccountEventArgs>Public Event AccountRemoved<MobileBroadbandAccountWatcher,  MobileBroadbandAccountEventArgs>// You can use this event in JavaScript.

Remarks

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

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

public : event TypedEventHandler AccountUpdated<MobileBroadbandAccountWatcher,  MobileBroadbandAccountUpdatedEventArgs>public event TypedEventHandler AccountUpdated<MobileBroadbandAccountWatcher,  MobileBroadbandAccountUpdatedEventArgs>Public Event AccountUpdated<MobileBroadbandAccountWatcher,  MobileBroadbandAccountUpdatedEventArgs>// You can use this event in JavaScript.

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:

• MobileBroadbandDeviceInformation class:

• CellularClass

• CurrentRadioState
• CustomDataClass
• DataClasses
• MobileEquipmentId
• DeviceType
• FirmwareInformation
• Manufacturer
• Model
• SimIccId
• SubscriberId

• TelephoneNumbers

• MobileBroadbandNetwork class:

• AccessPointName

• AccessPointName
• NetworkRegistrationState
• PacketAttachNetworkError
• RegistrationNetworkError

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

public : event TypedEventHandler EnumerationCompleted<MobileBroadbandAccountWatcher,  object>public event TypedEventHandler EnumerationCompleted<MobileBroadbandAccountWatcher,  object>Public Event EnumerationCompleted<MobileBroadbandAccountWatcher,  object>// You can use this event in JavaScript.

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.

Occurs when the MobileBroadbandAccountWatcher has stopped.

public : event TypedEventHandler Stopped<MobileBroadbandAccountWatcher,  object>public event TypedEventHandler Stopped<MobileBroadbandAccountWatcher,  object>Public Event Stopped<MobileBroadbandAccountWatcher,  object>// You can use this event in JavaScript.

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.