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

This structure defines the boundaries for the subset of broadcast messages that will be accepted.

Use this structure in conjunction with the SMS_RANGEstructure to define a mechanism to specify a list of cell broadcast ranges that the mobile will listen to. To specify individual IDs, use the same value for the minimum and maximum value.

Syntax 

typedef struct sms_broadcast_ranges_tag {
DWORD 
cbSize;
DWORD 
dwParams;
DWORD 
dwNumRanges;
DWORD 
dwBroadcastMsgLangs;
BOOL 
bAccept;
SMS_RANGE 
smsrBroadcastRanges[];
} SMS_BROADCAST_RANGES, *LPSMS_BROADCAST_RANGES;

Members

cbSize

The size of the list of message IDs.

dwParams

Determines which fields in the structure are valid. Possible values are listed in the following table.

Value Description

SMS_PARAM_SBR_BROADCASTMSGIDS

dwNumRangesand smsrBroadcastRangesfields are valid.

SMS_PARAM_SBR_BROADCASTMSGLANGS

dwBroadcastMsgLangsis valid.

SMS_PARAM_SBR_ACCEPTIDS

bAcceptfield is valid.
dwNumRanges

Indicates the number of ranges, which are elements in the smsrBroadcastRangesarray, that the mobile listens for.

dwBroadcastMsgLangs

Indicates the languages that the mobile provides. Possible values are listed in the following table.

Value Description

SMS_DCSLANG_UNKNOWN

Language is unknown.

SMS_DCSLANG_GERMAN

German language provided.

SMS_DCSLANG_ENGLISH

English language provided.

SMS_DCSLANG_ITALIAN

Italian language provided.

SMS_DCSLANG_FRENCH

French language provided.

SMS_DCSLANG_SPANISH

Spanish language provided.

SMS_DCSLANG_DUTCH

Dutch language provided.

SMS_DCSLANG_SWEDISH

Swedish language provided.

SMS_DCSLANG_DANISH

Danish language provided.

SMS_DCSLANG_PORTUGUESE

Portuguese language provided.

SMS_DCSLANG_FINNISH

Finnish language provided.

SMS_DCSLANG_NORWEGIAN

Norwegian language provided.

SMS_DCSLANG_GREEK

Greek language provided.

SMS_DCSLANG_TURKISH

Turkish language provided.

SMS_DCSLANG_HUNGARIAN

Hungarian language provided.

SMS_DCSLANG_POLISH

Polish language provided.

SMS_DCSLANG_CZECH

Czech language provided.

SMS_DCSLANG_ALL

All languages provided.
bAccept

True indicates that the messages identified in dwBroadcastMsgLangsand smsrBroadcastRangesare accepted. FALSE indicates that those messages are not accepted.

smsrBroadcastRanges

Indicates the ranges of IDs that the mobile listens for.

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