Share via


MobileBroadbandDeviceServiceTriggerDetails Class

Definition

Provides details for a network device service 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 MobileBroadbandDeviceServiceTriggerDetails sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class MobileBroadbandDeviceServiceTriggerDetails final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class MobileBroadbandDeviceServiceTriggerDetails
Public NotInheritable Class MobileBroadbandDeviceServiceTriggerDetails
Inheritance
Object Platform::Object IInspectable MobileBroadbandDeviceServiceTriggerDetails
Attributes

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 device service 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 device service notifications even while suspended, you must create a background work item to handle the messages. When a new device service notification arrives, the background work item will be activated. The MobileBroadbandDeviceServiceTriggerDetails class provides the details of the event to your background work item code.

Properties

DeviceId

Gets the device ID of the device that triggered a broadband device service event.

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.

DeviceServiceId

Gets the device service identifier for the device service trigger event.

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.

EventId
ReceivedData

Gets the received data associated with the triggered event.

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