Windows.Devices.Sms namespace

Applies to Windows only

Provides the ability to send, receive, delete, and get stored Short Message Service (SMS) messages, as well as query properties about a Mobile Broadband SMS Device and its message store.

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.

Members

The Windows.Devices.Sms namespace has these types of members:

Classes

The Windows.Devices.Sms namespace has these classes.

ClassDescription
DeleteSmsMessageOperation Enables start, track, and end an asynchronous message delete operation for a single message.
DeleteSmsMessagesOperation Enables start, track, and end asynchronous SMS message delete operations for multiple messages.
GetSmsDeviceOperation Retrieves an SmsDevice object asynchronously.
GetSmsMessageOperation Supports the retrieval of a message from the SMS message store.
GetSmsMessagesOperation Supports the retrieval of messages.
SendSmsMessageOperation Enables the sending of a message.
SmsBinaryMessage Represents an SMS message in raw PDU format. The data format differs depending on whether the message format (indicated by the value of the Format property) is GSM or CDMA.
SmsDevice Supports the operation of a mobile broadband SMS device.
SmsDeviceMessageStore Provides access to the messages stored on an SMS Device and information about the message store.
SmsMessageReceivedEventArgs Provides data for ISmsBinaryMessage event handlers.
SmsReceivedEventDetails Presents the details of SMS message events to the background work item that handles messages while your app is suspended.
SmsTextMessage 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.

 

Delegates

The Windows.Devices.Sms namespace has these delegates.

DelegateDescription
SmsDeviceStatusChangedEventHandler This handler is called when the status on the SMS device changes. Callers should implement this when they want to be notified when a significant state change occurs on the device. For example, the caller might want to know when the device is ready to send and receive messages.
SmsMessageReceivedEventHandler This event handler is called when a new binary message is received. Callers should implement this when they want to handle new binary messages from a given SMS device.

 

Enumerations

The Windows.Devices.Sms namespace has these enumerations.

EnumerationDescription
CellularClass This enumerated type defines the type of cellular device.
SmsDataFormat This enumerated type identifies the format of a given protocol description unit (PDU) buffer.
SmsDeviceStatus Contains values that indicate the readiness of an SMS device to engage in cellular network traffic operations.
SmsEncoding This enumerated type is used to determine the encoding algorithm to send or calculate the length of an SmsTextMessage object.
SmsMessageClass This enumerated type specifies the message class of a message. The message class typically originates on the network, not the mobile device.
SmsMessageFilter This enumerated type specifies which messages in the device message store an operation is performed on.
SmsMessageType This enumerated type defines whether the SMS message is encoded in binary or text format.

 

Interfaces

The Windows.Devices.Sms namespace defines these interfaces.

InterfaceDescription
ISmsBinaryMessage This interface provides access to the raw binary format of an SMS message. The message is stored in the industry standard protocol description unit (PDU) format (see the SMS specification GSM 03.40).
ISmsDevice This interface controls a mobile broadband SMS device. It is the primary entry point to SMS services on the device.
ISmsMessage This interface is implemented by all types of SMS messages that are supported.
ISmsTextMessage This interface manipulates a decoded SMS text message. It provides direct access to the plain text body of the message, as well as key header properties, such as time stamp.

 

Structures

The Windows.Devices.Sms namespace has these structures.

StructureDescription
SmsEncodedLength This structure represents information about the length of an SmsTextMessage object when it is encoded as a PDU.

 

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. All rights reserved.