Standard constructor.

Destructor. Deletes any dynamically allocated memory.

This function member gets a class that reflects the broadcast messaging capabilities of the phone.

This function member gets the current setting for the receipt of broadcast messages.

This setting will indicate whether all or no messages are being accepted or whether only those messages specified by the filters are going to be accepted or rejected.

If the returned setting, aSetting, equals EBroadcastAcceptFilter then the phone will accept messages whose identifier is included within the identifier list AND whose language is included within the language filter. If the returned setting, aSetting, equals EBroadcastRejectFilter then the phone will reject messages whose identifier is included within the identifier list OR whose language is included within the language filter.

N.B. If the phone supports both GSM/WCDMA and CDMA mode then it will probably need two identifier lists - one to contain a list of CBMI (for GSM/WCDMA mode) and the other to contain a list of Service Categories (for CDMA mode) This function member is synchronous because it is expected that this will be a TSY specific setting whose current value the TSY has previously determined.

This function member allows a client to retrieve the current contents of the broadcast message language filter.

Use RTelSubSessionBase::CancelAsyncRequest(EMobileBroadcastMessagingGetLanguageFilter) to cancel a previously placed asynchronous GetLanguageFilter() request.

This function member allows a client to be notified that changes have been made to the BroadcastId filter identifier list.

When it completes, it does not return the new version of the list so the client will have to retrieve the list using CRetrieveMobilePhoneBroadcastIdL again if it is interested in the new list.

Use RTelSubSessionBase::CancelAsyncRequest(EMobileBroadcastMessagingNotifyIdListChange) to cancel a previously placed asynchronous NotifyBroadcastIdListChange() request.

This function member allows a client to be notified if there is a change in the setting for the receipt of broadcast messages.

Use RTelSubSessionBase::CancelAsyncRequest(EMobileBroadcastMessagingNotifyFilterSettingChange) to cancel a previously placed asynchronous NotifyFilterSetting() request.

This function member allows a client to be notified if there is a change in the contents of the language filter.

Use RTelSubSessionBase::CancelAsyncRequest(EMobileBroadcastMessagingNotifyLanguageFilterChange) to cancel a previously placed asynchronous NotifyLanguageFilterChange() request.

This function member opens a Broadcast Messaging object. The name of the sub-session opened in the TSY will equal the string defined by the KETelBroadcastMessaging LIT definition.

This function member enables the client to receive the next incoming broadcast message from the network.

The request will be completed when a new message arrives. The client will pass a descriptor of size KBroadcastPageSize bytes, provided by the typedef TBroadcastPageData, to hold the returned broadcast message data into the aMsgData parameter.

This buffer size should be used for all types of messages: GSM, CDMA and WCDMA.

The function explicity checks that the aMsgData parameter is of size KBroadcastPageSize. If the buffer size does not equal KBroadcastPageSize, the client request will be completed with KErrArgument.

A TSY should handle ReceiveMessage() requests by making them repost immediately (to ensure none are missed) and possibly multiple completion enabled. When a new message arrives the TSY will copy the broadcast message contents into its stored pointer to the broadcast message data, fill in the broadcast message attributes and then complete the request.

This function member sets a new setting for the receipt of broadcast messages.

This setting will specify whether all or no messages are being accepted or whether only those messages specified by the filters are going to be accepted or rejected.

Use RTelSubSessionBase::CancelAsyncRequest(EMobileBroadcastMessagingSetFilterSetting) to cancel a previously placed asynchronous SetFilterSetting() request.

This function member allows a client to store new contents for the broadcast message language filter.

Use RTelSubSessionBase::CancelAsyncRequest(EMobileBroadcastMessagingSetLanguageFilter) to cancel a previously placed asynchronous SetLanguageFilter() request.

This function member may be used to store a new version of the entire BroadcastId list of identifier entries.

The list, should not contain more entries than can be stored phone-side. This function member will store all the identifier list entries into the phone-side storage. It will overwrite the current contents of the storage and may cause other clients to be notified of the change in identifier list.

Due to the probable time taken to store a list, there is only an asynchronous version of this function member. This function member will leave if an out of memory error occurs during allocation of a client-side buffer in which to store the streamed list contents.

Use RTelSubSessionBase::CancelAsyncRequest(EMobileBroadcastMessagingStoreIdList) to cancel a previously placed asynchronous StoreBroadcastIdListL() request. Will leave if the CBufFlat to hold the streamed contents can not be allocated

A constant which defines the length of the buffer to be passed to ReceiveMessage.

This constant should be used for all message types: GSM, CDMA and WCDMA.

Old buffer sizes. KBroadcastPageSize should be used instead.

Broadcast message filter capabilities.

Modes: Common

RMobileBroadcastMessaging::GetLanguageFilter()

Defines the broadcast attributes.

Modes: Common

The mobile broadcast data format, used byTMobileBroadcastAttributesV1.

Modes: Common

Defines the broadcast types.

Broadcast capabilities.

Modes:GSM/WCDMA

The filter settings of the mobile phone.

Modes: Common

Buffer for received messages.

This buffer should be used for all message types: GSM, CDMA and WCDMA.

Buffer for CDMA messages. TBroadcastPageData should be used instead. 9.5

Buffer for GSM messages. TBroadcastPageData should be used instead.

A typedef'd packaged TMobileBroadcastAttributesV1 for passing through a generic API function member.

A typedef'd packaged TMobileBroadcastAttributesV1 for passing through a generic API function member.

A typedef'd packaged TMobileBroadcastCapsV1 for passing through a generic API function member.

Buffer for WCDMA messages. TBroadcastPageData should be used instead.