This topic has not yet been rated - Rate this topic

SmsDevice class

Supports the operation of a mobile broadband SMS device.

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 smsDevice = Windows.Devices.Sms.SmsDevice;

Attributes

DualApiPartitionAttribute()
StaticAttribute(Windows.Devices.Sms.ISmsDeviceStatics, NTDDI_WIN8)
ThreadingAttribute(Both)
VersionAttribute(NTDDI_WIN8)

Members

The SmsDevice class has these types of members:

Events
Methods
Properties

Events

The SmsDevice class has these events.

Event	Description
SmsDeviceStatusChanged	Sets an event handler to be called when the status of the SMS device changes.
SmsMessageReceived	Sets an event handler to be called when the device receives a new text message.

Methods

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

Method	Description
CalculateLength	Estimates the transmitted message length of the specified text message. The estimate can be useful to clients who want to give an indication of how many messages will be sent on the network to carry the text of the full message.
FromIdAsync	Creates an instance of SmsDevice for the device that received the SMS message.
GetDefaultAsync	Creates an instance of an SmsDevice object associated with the default SMS device. Because the device might be busy, the operation executes asynchronously. The asynchronous operation object returns immediately.
GetDeviceSelector	Retrieves the class selection string that can be used to enumerate SMS devices.
SendMessageAsync	Asynchronously sends a message using the SMS device. The method is asynchronous because the send operation might not occur instantaneously. The message operation object is returned immediately.

Properties

The SmsDevice class has these properties.

Property	Access type	Description
AccountPhoneNumber	Read-only	Returns the phone number associated with the SMS device. The phone number can be used to associate incoming messages with the account and possibly an external storage mechanism such as an account inbox.
CellularClass	Read-only	Returns the cellular class of the SMS device. The class can be used to determine which encodings are appropriate or which device limitations are in effect.
DeviceStatus	Read-only	Returns the SMS device's status, which indicates whether the device is ready, or not. It also indcates what type of problem exists if the device is not ready.
MessageStore	Read-only	Accesses the on-device message store. The store holds messages until a client can retrieve them. On some devices, for example, the store may correspond to the SIM storage for SMS messages.

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