Windows desktop applications
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

SmsReceivedEventDetails class

Presents the details of SMS message events to the background work item that handles messages while your app is suspended.

Note  This functionality is only available to mobile operator apps and Windows Store apps given privileged access by mobile network operators, mobile broadband adapter IHV, or OEM. For more information, see Mobile Broadband: Windows Store device apps.
 

Note  Note that this class and its methods are supported for the maintenance of legacy desktop apps that used it in earlier versions of Windows; and if you do use this class, you must specify the Windows.Devices.Sms.LegacySmsApiContract in your app's manifest. Do not use this class if you are developing new apps for Windows 10. Instead, use the members of this namespace that do not require the Windows.Devices.Sms.LegacySmsApiContract.
 

Syntax


Public NotInheritable Class SmsReceivedEventDetails

Members

The SmsReceivedEventDetails class has these types of members:

Properties

The SmsReceivedEventDetails class has these properties.

PropertyAccess typeDescription

BinaryMessage

Read-only

Gets the binary message object for the SMS message received by the background task.

DeviceId

Read-only

Returns the DeviceInformation ID of the network interface that received the SMS message. This ID can be passed to SmsDevice.FromIdAsync to activate the device and retrieve additional message details.

MessageClass

Read-only

Gets the message class for the SMS message received by the background task.

MessageIndex

Read-only

Returns the index of the new message that raised the event. You can pass this to SmsDevice.GetMessageAsync to retrieve the new message itself.

 

Remarks

Windows extends battery life by suspending applications that are not in the foreground. If your application needs to handle new SMS messages even while it is suspended, it needs to create a background work item to handle this. When a new SMS message arrives, the background work item is activated.

Requirements (Windows 10 device family)

Device family

Desktop, introduced version 10.0.10240.0

API contract

Windows.Devices.sms.LegacysmsApiContract, introduced version 1.0

Namespace

Windows.Devices.Sms
Windows::Devices::Sms [C++]

Metadata

Windows.Devices.sms.LegacysmsApiContract.winmd

Capabilities

sms
cellularMessaging

Requirements (Windows 8.x and Windows Phone 8.x)

Minimum supported client

Windows 8 [Windows Store apps, desktop apps]

Minimum supported server

Windows Server 2012 [Windows Store apps, desktop apps]

Minimum supported phone

None supported

Namespace

Windows.Devices.Sms
Windows::Devices::Sms [C++]

Metadata

Windows.winmd

Capabilities

sms
cellularMessaging

Attributes

[Deprecated()]
[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Version(0x06020000)]

See also

Object

 

 

Show:
© 2016 Microsoft