NOTIFICATION_PROVIDER_SPECIFIC_DATA (Windows Embedded CE 6.0)

1/6/2010

The notification provider is a basic Short Message Service (SMS) protocol type that will handle all known "message waiting" (ex: voicemail) type SMS messages and provide the information in a common format. Refer to GSM specification 03.40 "Digital cellular telecommunications system (Phase 2+); Technical realization of the Short Message Service (SMS)", GSM specification 03.38 "Digital cellular telecommunications system (Phase 2+); Alphabets and language-specific information", and the Common PCN Handset Specification (CPHS) for details on the supported message formats.

This structure provides a description of the fields encoded in the provider-specific portion of this message during SmsReadMessage calls.

Syntax

typedef struct notification_provider_specific_data_tag {
    DWORD dwMessageOptions;
    PROVIDER_SPECIFIC_MESSAGE_CLASS psMessageClass;
    PROVIDER_SPECIFIC_REPLACE_OPTION psReplaceOption;
    NOTIFICATION_PROVIDER_SPECIFIC_MSG_WAITING_TYPE npsMsgWaitingType;
    int iNumberOfMessagesWaiting;
    NOTIFICATION_PROVIDER_SPECIFIC_INDICATOR_TYPE npsIndicatorType;
} NOTIFICATION_PROVIDER_SPECIFIC_DATA;

Members

• dwMessageOptions
  Indicates various text message options.

  Note

  This also applies to dwMessage options in the text provider.

  Value	Description
  PS_MESSAGE_OPTION_NONE	Specifies that no options are being used.
  PS_MESSAGE_OPTION_REPLYPATH	On sending, the TP_REPLY_PATH parameter should be set. Refer to GSM specification 3.40 (Annex D) for further details.
  PS_MESSAGE_OPTION_STATUSREPORT	On sending, the TP_STATUS_REPORT_REQUEST parameter should be set to request a status report for the outgoing message. Refer to GSM specification 3.40 (Annex D) for further details.
  PS_MESSAGE_OPTION_DISCARD	On sending, the TP_USER_DATA_HEADER parameter should be set to request that the discard bit be set for the outgoing message. Refer to GSM specification 3.40 (Annex D) for further details.

• psMessageClass
  Text SMS messages with the appropriate flag can replace previously received notifications with a similar flag and originating address. See the PROVIDER_SPECIFIC_MESSAGE_CLASS enumeration for possible values.

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

• npsMsgWaitingType
  The type of the notification message. See the NOTIFICATION_PROVIDER_SPECIFIC_MSG_WAITING_TYPE enumeration for possible values.

• iNumberOfMessagesWaiting
  Number of messages waiting.

• npsIndicatorType
  Indicates the cellular line a notification is for. See the NOTIFICATION_PROVIDER_SPECIFIC_INDICATOR_TYPE enumeration for possible values.

Requirements

See Also

Reference

Short Message Service Structures
PROVIDER_SPECIFIC_MESSAGE_CLASS
PROVIDER_SPECIFIC_REPLACE_OPTION
NOTIFICATION_PROVIDER_SPECIFIC_MSG_WAITING_TYPE
NOTIFICATION_PROVIDER_SPECIFIC_INDICATOR_TYPE