Windows.Devices.Sms namespace
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.
| Class | Description |
|---|---|
| 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.
| Delegate | Description |
|---|---|
| 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.
| Enumeration | Description |
|---|---|
| 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.
| Interface | Description |
|---|---|
| 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.
| Structure | Description |
|---|---|
| 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 |
|
Namespace |
|
|
Metadata |
|
|
Capabilities |
|
Build date: 12/4/2012
