PROVIDER_SPECIFIC_MESSAGE_CLASS

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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. Refer to GSM specification 03.40 "Digital Cellular telecommunications system (Phase 2+); Technical realization of the Short Message Service (SMS)" for more details.

Syntax

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

Enumerators

• PS_MESSAGE_CLASS0
  The message should be displayed immediately but not stored. The 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" at this 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)" at this Web site.

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

Remarks

For CDMA, use the value CLASS 0 to display the message immediately, and use CLASS 1, CLASS 2, and CLASS 3 for the default behavior.

Requirements

See Also

Reference

Short Message Service Enumerations
TEXT_PROVIDER_SPECIFIC_DATA
NOTIFICATION_PROVIDER_SPECIFIC_DATA
SmsSendMessage
SmsReadMessage
SmsOpen