Share via

NOTIFICATION_PROVIDER_SPECIFIC_DATA (Windows Embedded CE 6.0)

  • Article

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.

Note

For CDMA, use the value CLASS 0 to display the message immediately (and any other value for the default behavior).

  • 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

Header sms.h
Windows Embedded CE Windows Embedded CE 6.0 and later

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