NOTIFICATION_PROVIDER_SPECIFIC_DATA

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The notification provider is a basic Short Message Service (SMS) protocol type that will handle all known "message waiting" (ex: voice mail) 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
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 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