ISmsDevice interface

Applies to Windows only

This interface controls a mobile broadband SMS device. It is the primary entry point to SMS services on the 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


public interface ISmsDevice

Attributes

[Version(0x06020000)]

Members

The ISmsDevice interface has these types of members:

Events

The ISmsDevice interface has these events.

EventDescription
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 ISmsDevice interface has these methods. It also inherits methods from the Object class.

MethodDescription
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.
SendMessageAsync Asynchronously sends a message using the SMS device. The method is asynchronous because the send operation might not occur instantaneously. The asynchronous operation object is returned immediately.

 

Properties

The ISmsDevice interface has these properties.

PropertyAccess typeDescription

AccountPhoneNumber

Read-onlyReturns 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-onlyReturns 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-onlyReturns 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-onlyAccesses 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

Minimum supported server

Windows Server 2012

Minimum supported phone

None supported

Namespace

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

Metadata

Windows.winmd

Capabilities

sms

 

 

Show:
© 2014 Microsoft