MobileBroadbandDeviceServiceTriggerDetails Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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
- 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. |