NOTIFICATION_PROVIDER_SPECIFIC_DATA
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.
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
Smartphone: Smartphone 2002 and later
Pocket PC: Pocket PC 2002 and later
OS Versions: Windows CE 3.0 and later
Header: sms.h
Library: sms.lib
See Also
Short Message Service Structures | PROVIDER_SPECIFIC_MESSAGE_CLASS | PROVIDER_SPECIFIC_REPLACE_OPTION | NOTIFICATION_PROVIDER_SPECIFIC_MSG_WAITING_TYPE | NOTIFICATION_PROVIDER_SPECIFIC_INDICATOR_TYPE
Send Feedback on this topic to the authors