Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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 SmsReadMessagecalls.

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 dwMessageoptions 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_PATHparameter should be set. Refer to GSM specification 3.40 (Annex D) for further details.

PS_MESSAGE_OPTION_STATUSREPORT

On sending, the TP_STATUS_REPORT_REQUESTparameter 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_HEADERparameter 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