MobileBroadbandNetworkRegistrationStateChangeTriggerDetails Class

  • Reference

Definition

Namespace:
Windows.Networking.NetworkOperators
Edit

Provides details for a network registration state change notification.

Note

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

If you want to use this API and publish your app to the Microsoft Store, then you'll need special approval. For more information, see the Restricted capabilities section in the App capability declarations topic.

public ref class MobileBroadbandNetworkRegistrationStateChangeTriggerDetails sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class MobileBroadbandNetworkRegistrationStateChangeTriggerDetails final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class MobileBroadbandNetworkRegistrationStateChangeTriggerDetails
Public NotInheritable Class MobileBroadbandNetworkRegistrationStateChangeTriggerDetails
Inheritance
Object Platform::Object IInspectable MobileBroadbandNetworkRegistrationStateChangeTriggerDetails
Attributes
ContractVersionAttribute MarshalingBehaviorAttribute

Windows requirements

Device family
Windows 10 (introduced in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduced in v1.0)
App capabilities
cellularDeviceControl cellularDeviceIdentity

Remarks

When a background task is triggered by a mobile network registration state change notification, the IBackgroundTaskInstance.TriggerDetails property returns an instance of this class with information specific to the triggered notification.

The operating system extends battery life by suspending applications that are not in the foreground. If your application must handle new network registration state change notifications even while suspended, you must create a background work item to handle the messages. When a new network registration state change notification arrives, the background work item will be activated. The MobileBroadbandNetworkRegistrationStateChangeTriggerDetails class provides the details of the event to your background work item code.

Properties

NetworkRegistrationStateChanges

Gets the collection of network registration state changes associated with this notification.

Note

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

If you want to use this API and publish your app to the Microsoft Store, then you'll need special approval. For more information, see the Restricted capabilities section in the App capability declarations topic.

Applies to