TEXT_PROVIDER_SPECIFIC_DATA

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure is used for provider-specific data for use with SmsSendMessage and SmsReadMessage. The text provider is the most basic Short Message Service (SMS) protocol type. The content of the message is simply a text string. Note that 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)," are supported.

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
  Indicates various text message options. For a list of possible options, see the Message option constants table in Remarks.

• psMessageClass
  Text Short Message Service (SMS) messages with the appropriate flag can replace previously received notifications with a similar flag and originating address. For possible values, see the PROVIDER_SPECIFIC_MESSAGE_CLASS enumeration.

• psReplaceOption
  Text SMS messages with the appropriate flag can replace previously received notifications with a similar flag and originating address. For possible values, see the PROVIDER_SPECIFIC_REPLACE_OPTION enumeration.

• dwHeaderDataSize
  The size of the header. For multi-part messages, this is the size of each segment's header.

• pbHeaderData[SMS_DATAGRAM_SIZE]
  The information contained in the header. For multi-part messages, only the header from the first segment is returned. The size must be zero for ordinary text messages.

• fMessageContainsEMSHeaders
  Flag that indicates that at least one segment of this message contains EMS headers. Only set this flag if the EMS handler is installed. This flag only applicable on incoming messages.

• dwProtocolID
  The Protocol Identifier (PID) of an incoming message, or the desired PID of an outgoing message. This applies to GSM only. Set to SMS_MSGPROTOCOL_UNKNOWN if psReplaceOption is not PSRO_NONE. For the complete set of possible PID constants, see the Protocol Identifier (PID) constants table in Remarks.

• dwExtParams
  Bit field of valid additional structure parameters. Possible values are listed in the following table.

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

• tpsPriority
  Priority indicator. Applies only to CDMA IS637. For the set of possible values, see the TEXT_PROVIDER_SPECIFIC_PRIORITY_TYPE enumeration.

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

Remarks

Message option constants for the dwMessageOptions parameter.

Protocol Identifier (PID) constants for the dwProtocolID parameter.

Bitfield values for the dwExtParamProt parameter.

Requirements

See Also

Reference

Short Message Service Structures
PROVIDER_SPECIFIC_MESSAGE_CLASS
PROVIDER_SPECIFIC_REPLACE_OPTION
SmsSendMessage
SmsReadMessage