SMS_BROADCAST_RANGES

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

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_RANGE structure 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

    dwNumRanges and smsrBroadcastRanges fields are valid.

    SMS_PARAM_SBR_BROADCASTMSGLANGS

    dwBroadcastMsgLangs is valid.

    SMS_PARAM_SBR_ACCEPTIDS

    bAccept field is valid.
  • dwNumRanges
    Indicates the number of ranges, which are elements in the smsrBroadcastRanges array, 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 dwBroadcastMsgLangs and smsrBroadcastRanges are 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

Reference

Short Message Service Structures
SmsGetBroadcastMsgRanges
SmsSetBroadcastMsgRanges