<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE task

  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

<task id="GUID-76D2CDCA-DD7C-56D4-A913-6A959686B8D5" xml:lang="en"><title>MBMS

Context Tutorial </title><shortdesc>This tutorial describes how to use the MBMS related context functions

in a packet service. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<steps id="GUID-8BAECB15-BE6A-5E56-AF50-68C98200C5C2">

<step id="GUID-06800D0F-5098-572D-BC69-CF29626C25D3"><cmd/>

<info>Use <xref href="GUID-AC71A07E-90ED-36D9-B745-A2F25EC582D7.dita#GUID-AC71A07E-90ED-36D9-B745-A2F25EC582D7/GUID-97C7D5FD-6FE0-3359-9299-31AEFF0754A6"><apiname>RPacketMbmsContext::OpenNewContext()</apiname></xref> to open

a new context. </info>

</step>

<step id="GUID-2748A927-7991-53D5-B39E-3F6A049FA9EA"><cmd/>

<info>To retrieve the active list of MBMS services do the following </info>

<substeps id="GUID-CC8BFA90-26E5-4136-8B5E-1EF378B5A1EE">

<substep id="GUID-0EA2D091-038A-4C39-A535-66501B3B062B"><cmd/>

<info>create an instance of <xref href="GUID-D7C9ACE9-A5AF-30F6-8DC9-DD2B1E515532.dita"><apiname>CRetrievePcktMbmsSessionList</apiname></xref>  </info>

</substep>

<substep id="GUID-9090F617-ADB0-4552-B0F3-D1FEC1DC1201"><cmd/>

<info>use <xref href="GUID-D7C9ACE9-A5AF-30F6-8DC9-DD2B1E515532.dita#GUID-D7C9ACE9-A5AF-30F6-8DC9-DD2B1E515532/GUID-A89411DB-DF77-34CA-8577-09C2CDC711D3"><apiname>CRetrievePcktMbmsSessionList::Start()</apiname></xref> to start

the asynchronous retrieval. </info>

</substep>

<substep id="GUID-9C6954A6-576E-4730-BF2A-290318648831"><cmd/>

<info>use <xref href="GUID-D7C9ACE9-A5AF-30F6-8DC9-DD2B1E515532.dita#GUID-D7C9ACE9-A5AF-30F6-8DC9-DD2B1E515532/GUID-125580FA-D92E-30A8-8759-81C0CE8B8817"><apiname>CRetrievePcktMbmsSessionList::RestoreListL()</apiname></xref> to

extract the data from the response of start() function and build the list

of services. </info>

</substep>

<substep id="GUID-D37C6C27-5628-42F9-B34E-DCEDA66E2DC2"><cmd/>

<info>use <xref href="GUID-D7C9ACE9-A5AF-30F6-8DC9-DD2B1E515532.dita#GUID-D7C9ACE9-A5AF-30F6-8DC9-DD2B1E515532/GUID-455212AF-AE82-3E8D-A265-A2DB72457C63"><apiname>CRetrievePcktMbmsSessionList::Cancel()</apiname></xref> to cancel

the retrieval process. </info>

</substep>

<substep id="GUID-8A455BE8-5CE7-475F-A7DA-BD26138350BB"><cmd/>

<info>use <xref href="GUID-EA37BDA7-AA72-3B58-B65F-088B8192DC91.dita#GUID-EA37BDA7-AA72-3B58-B65F-088B8192DC91/GUID-E0D1FB51-436E-3FDB-892E-6954E9B401A5"><apiname>CMbmsSession::NewL()</apiname></xref> to create an object to store

the list. </info>

</substep>

<substep id="GUID-86F07709-E948-447C-9A57-D894B0488CBB"><cmd/>

<info>use <xref href="GUID-EA37BDA7-AA72-3B58-B65F-088B8192DC91.dita#GUID-EA37BDA7-AA72-3B58-B65F-088B8192DC91/GUID-B92515C2-BE74-3A17-8C52-FB3051596227"><apiname>CMbmsSession::ExternalizeL()</apiname></xref> to prepare the data

to be referenced. </info>

<info>use <xref href="GUID-EA37BDA7-AA72-3B58-B65F-088B8192DC91.dita#GUID-EA37BDA7-AA72-3B58-B65F-088B8192DC91/GUID-6179D0C8-932E-3311-8C49-E0B6F2D0FFEF"><apiname>CMbmsSession::InternalizeL()</apiname></xref> to populate the

object with the data from the buffer. </info>

</substep>

</substeps>

</step>

<step id="GUID-2DAC996D-73AF-53B3-9D62-BD3F56421BF1"><cmd/>

<info>use<xref href="GUID-AC71A07E-90ED-36D9-B745-A2F25EC582D7.dita#GUID-AC71A07E-90ED-36D9-B745-A2F25EC582D7/GUID-521A261F-449B-31C1-A4DB-44F446429BE1"><apiname>RPacketMbmsContext::UpdateMbmsSessionList()</apiname></xref> to

update the service list. </info>

</step>

<step id="GUID-DC9A4399-0251-5F0D-BF38-DDC7516C5BF1"><cmd/>

<info>use <xref href="GUID-D8BBA972-82CB-3561-8913-4659103C263C.dita#GUID-D8BBA972-82CB-3561-8913-4659103C263C/GUID-3BF91830-2F1C-3635-B362-AECB5C1D8619"><apiname>RTelSubSessionBase::CancelAsyncRequest()</apiname></xref> to cancel

the update function call. </info>

</step>

</steps>

</taskbody></task>