TEXT_PROVIDER_SPECIFIC_DATA (Compact 2013)

3/26/2014

This structure contains thedata about the text message provider that SmsSendMessage uses.

Syntax

typedef struct text_provider_specific_data_tag {
    DWORD dwMessageOptions;
    PROVIDER_SPECIFIC_MESSAGE_CLASS psMessageClass;
    PROVIDER_SPECIFIC_REPLACE_OPTION psReplaceOption;
    DWORD dwHeaderDataSize;
    BYTE pbHeaderData[SMS_DATAGRAM_SIZE];
    BOOL fMessageContainsEMSHeaders;
    DWORD dwProtocolID;
    DWORD dwExtParams;
    TEXT_PROVIDER_SPECIFIC_PRIORITY_TYPE tpsPriority;
    SMS_ADDRESS smsaCallBack;
} TEXT_PROVIDER_SPECIFIC_DATA;

Members

• dwMessageOptions
  One or more message options composed of a bitwise combination of one or more SMS Provider Specific Message Options Constants values.

• psMessageClass
  A PROVIDER_SPECIFIC_MESSAGE_CLASS value.

• psReplaceOption
  A PROVIDER_SPECIFIC_REPLACE_OPTION value.

• dwHeaderDataSize
  Size of the header. For multipart messages, this value is the size of each segment's header.

• pbHeaderData[ SMS_DATAGRAM_SIZE ]
  The information contained in the header.

  For multipart messages, only the header of the first segment is returned.

  The size must be zero for ordinary text messages.

• fMessageContainsEMSHeaders
  Set when one or more segments of the message contain Enterprise Message Service (EMS) headers and the EMS handler is installed.

  This flag applies to incoming messages only.

• dwProtocolID
  A SMS Message Protocol Constants value.

  Applies only to Global System for Mobile Communications (GSM).

  Protocol of incoming message or desired protocol of outgoing message.

  Set to SMS_MSGPROTOCOL_UNKNOWN if psReplaceOption is not PSRO_NONE.

• dwExtParams
  Bit field of valid additional structure parameters. Possible values are:

  Constant	Value
  TEXTPSEXTPARM_NONE	0x00000000
  TEXTPSEXTPARM_CALLBACK	0x00000001
  TEXTPSEXTPARM_PRIORITY	0x00000002
  TEXTPSEXTPARM_ALL	0x00000003

• tpsPriority
  A TEXT_PROVIDER_SPECIFIC_PRIORITY_TYPE enumeration value that indicates the message priority. Applies only to CDMA IS637.

• smsaCallBack
  Callback number. Applies only to CDMA IS637. For more information, refer to SMS_ADDRESS.

Remarks

The text provider is the most basic Short Message Service (SMS) provider type. The content of the message is simply a text string that supports Phase 2 fragmentation and reassembly, according to GSM specification 3.40, "Digital cellular telecommunications system (Phase 2+); Technical realization of the Short Message Service (SMS)" on the 3GPP Web site.

Requirements

Header

sms.h

See Also

Reference

Short Message Service Structures
PROVIDER_SPECIFIC_MESSAGE_CLASS
PROVIDER_SPECIFIC_REPLACE_OPTION
SmsSendMessage
SMS Message Protocol Constants