2 out of 2 rated this helpful - Rate this topic

SmsTextMessage class

Manages a decoded SMS text message, providing direct access to the plain text body of the message, as well as key header properties, such as time stamp.

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.

Syntax

JavaScript

C++


var smsTextMessage = new Windows.Devices.Sms.SmsTextMessage();

Attributes

ActivatableAttribute(NTDDI_WIN8)
DualApiPartitionAttribute()
MarshalingBehaviorAttribute(Agile)
StaticAttribute(Windows.Devices.Sms.ISmsTextMessageStatics, NTDDI_WIN8)
ThreadingAttribute(Both)
VersionAttribute(NTDDI_WIN8)

Members

The SmsTextMessage class has these types of members:

Constructors
Methods
Properties

Constructors

The SmsTextMessage class has these constructors.

Constructor	Description
SmsTextMessage	Creates an instance of the SmsTextMessage class.

Methods

The SmsTextMessage class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.

Method	Description
FromBinaryData	Decodes a binary message and places the results in a new instance of a text message. This method represents the binary message as a reference to a buffer of bytes and a selection of how the buffer is encoded. Therefore, it can be used when the message did not originate directly from the device or as an instance of an SmsBinaryMessage class.
FromBinaryMessage	Reads a binary message and decodes it. The results are placed in a new instance of a text message.
ToBinaryMessages	Reads a message in the specified format and places the results in a new instance of a binary message.

Properties

The SmsTextMessage class has these properties.

Property	Access type	Description
Body	Read/write	Specifies the plain text body of the message.
Encoding	Read/write	Specifies the encoding type that has been set to use when sending this message.
From	Read/write	Specifies the phone number of the sender of the message.
Id	Read-only	Indicates the ID of the SMS text message.
MessageClass	Read-only	Specifies the message class of a message. This message class typically originates on the network, not the mobile device.
PartCount	Read-only	Indicates the total number of parts in the original message if the message is part of a multi-part message.
PartNumber	Read-only	Indicates the part number of a multi-part message if this message is part of a multi-part message. It can be used to reconstruct the original message by joining the parts together, in conjunction with the PartReferenceId and PartCount properties.
PartReferenceId	Read-only	Indicates a reference value that can be used if the message is part of a multi-part message. If this message belongs to a multi-part message, the PartNumber value can be used to reconstruct the full original message, and each part of that message will have the same value for PartReferenceId.
Timestamp	Read-only	Indicates the timestamp of the message. It is determined locally for a constructed message instance or from the service center timestamp of a received message.
To	Read/write	Indicates the recipient phone number of this message.

Requirements

Minimum supported client	Windows 8 [Windows Store apps, desktop apps]
Minimum supported server	Windows Server 2012 [Windows Store apps, desktop apps]
Namespace	Windows.Devices.Sms Windows::Devices::Sms [C++]
Metadata	Windows.winmd
Capabilities	sms

Build date: 12/4/2012