PROVIDER_SPECIFIC_MESSAGE_CLASS (Compact 2013)

3/26/2014

Text Short Message Service (SMS) messages with the appropriate flag can replace previously received notifications with a similar flag and originating address.

Use this enumeration with the TEXT_PROVIDER_SPECIFIC_DATA, and NOTIFICATION_PROVIDER_SPECIFIC_DATA structures when calling SmsSendMessage and SmsReadMessage after having called SmsOpen with the message class.

For code division multiple access (CDMA), use PS_MESSAGE_CLASS0 to immediately display the message, and any other value for the default behavior.

Refer to GSM specification 03.40 "Digital Cellular telecommunications system (Phase 2+); Technical realization of the Short Message Service (SMS)" for details.

Syntax

enum PROVIDER_SPECIFIC_MESSAGE_CLASS {
    PS_MESSAGE_CLASS0 = 0,
    PS_MESSAGE_CLASS1,
    PS_MESSAGE_CLASS2,
    PS_MESSAGE_CLASS3,
    PS_MESSAGE_CLASSUNSPECIFIED,
};

Elements

• PS_MESSAGE_CLASS0
  The message should be displayed immediately but not stored. The message service (MS) shall send an acknowledgement to the service center when the message has successfully reached the MS.

• PS_MESSAGE_CLASS1
  The message should be stored and an acknowledgement should be sent to the Service Center when it is stored.

• PS_MESSAGE_CLASS2
  The message should be transferred to the SMS data field in the subscriber identity module (SIM) before an acknowledgement is sent to the Service Center. If the message cannot be stored in the SIM and there is other short message storage available, an unspecified protocol error message is returned to the Service Center. For more information, see GSM specification 04.11 "Digital cellular telecommunications system (Phase 2+); Point-to-Point (PP) Short Message Service (SMS) support on mobile radio interface" on the 3GPP web site. If all of the short message storage is already in use, a memory error message is returned to the service center.

• PS_MESSAGE_CLASS3
  When the message has successfully reached the destination and can be stored, an acknowledgement is sent to the Service Center. For more information, see GSM specification 07.05 "Digital cellular telecommunications system (Phase 2+); Use of Data Terminal Equipment - Data Circuit terminating; Equipment (DTE - DCE) interface for Short Message Service (SMS) and Cell Broadcast Service (CBS)" on the 3GPP web site.

• PS_MESSAGE_CLASSUNSPECIFIED
  The message Class is not set in the outgoing or incoming message.

Remarks

Requirements

Header

sms.h

See Also

Reference

Short Message Service Enumerations
TEXT_PROVIDER_SPECIFIC_DATA
NOTIFICATION_PROVIDER_SPECIFIC_DATA
SmsSendMessage
SmsReadMessage
SmsOpen