Share via

MobileBroadbandRadioStateChangeTriggerDetails Class

  • Reference

Definition

Namespace:
Windows.Networking.NetworkOperators
Edit

Provides details for a radio 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 MobileBroadbandRadioStateChangeTriggerDetails sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class MobileBroadbandRadioStateChangeTriggerDetails final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class MobileBroadbandRadioStateChangeTriggerDetails
Public NotInheritable Class MobileBroadbandRadioStateChangeTriggerDetails
Inheritance
Object Platform::Object IInspectable MobileBroadbandRadioStateChangeTriggerDetails
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 radio 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 radio state change notifications even while suspended, you must create a background work item to handle the messages. When a new radio state change notification arrives, the background work item will be activated. The MobileBroadbandRadioStateChangeTriggerDetails class provides the details of the event to your background work item code.

Properties

RadioStateChanges

Gets the collection of radio state change details associated with a 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