Symbian3/PDK/Source/GUID-76D2CDCA-DD7C-56D4-A913-6A959686B8D5.dita
changeset 1 25a17d01db0c
child 3 46218c8b8afa
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/PDK/Source/GUID-76D2CDCA-DD7C-56D4-A913-6A959686B8D5.dita	Fri Jan 22 18:26:19 2010 +0000
@@ -0,0 +1,60 @@
+<?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>
\ No newline at end of file