<?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-749DE15A-E731-5BCE-AB43-6BFD49729A05" xml:lang="en"><title>Packet
List Tutorial </title><shortdesc>This tutorial describes how to use the list functions related to
a packet service sub-session. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
<context id="GUID-90BEEB4E-BAB5-55F1-9FEF-517C241A1DB8"><p>Packet lists are
used to store data related to device. The list function related to the packet
service is derived from <xref href="GUID-2212326F-F33F-3DB6-BEB9-EDDE37ED84A8.dita"><apiname>CMobilePhoneListBase</apiname></xref> and <xref href="GUID-A07D2006-812C-3E5E-A204-453092E6020A.dita"><apiname>CMobilePhoneEditableListBase</apiname></xref>.
This tutorial describes the list functions that are provided for the packet
service client applications to add, update or delete the data in the lists. The
following section provides the details of the functions derived from <xref href="GUID-2212326F-F33F-3DB6-BEB9-EDDE37ED84A8.dita"><apiname>CMobilePhoneListBase</apiname></xref> class
for the packet service client applications. </p> </context>
<steps id="GUID-5E96804C-A1D6-50E4-9A8D-258B4CB6698A">
<step id="GUID-7B589609-98D4-54E5-BFFA-D450DE8F22E9"><cmd/>
<info>Use <xref href="GUID-F2BC08E0-3C84-305B-B532-B47331E39A13.dita#GUID-F2BC08E0-3C84-305B-B532-B47331E39A13/GUID-3A5B7FAA-FCFD-3851-A084-DC3FD1A72344"><apiname>CMobilePhoneListbase::Enumerate()</apiname></xref> to retrieve
the current entries in the list. </info>
</step>
<step id="GUID-650C078B-E5C1-5854-B102-E4416E607B41"><cmd/>
<info>Use <xref href="GUID-F2BC08E0-3C84-305B-B532-B47331E39A13.dita#GUID-F2BC08E0-3C84-305B-B532-B47331E39A13/GUID-447FFA64-F939-3AD2-A48F-B11F2FBBDAF9"><apiname>CMobilePhoneListbase::MaxNumberEntries()</apiname></xref> to get
the maximum number of entries that can be stored in a list. </info>
</step>
<step id="GUID-44E11F41-FBD6-5A3B-A1CF-456E6D55948B"><cmd/>
<info>Use <xref href="GUID-F2BC08E0-3C84-305B-B532-B47331E39A13.dita#GUID-F2BC08E0-3C84-305B-B532-B47331E39A13/GUID-A0DAD0A5-0D13-370D-BBB4-F0E9D2E513FE"><apiname>CMobilePhoneListbase::SetMaxNumberEntries()</apiname></xref> to
set the maximum number of entries that can be stored in a list. </info>
</step>
<step id="GUID-D537CF28-DE99-5370-8D41-8AFFB9E2B428"><cmd/>
<info>Use <xref href="GUID-F2BC08E0-3C84-305B-B532-B47331E39A13.dita#GUID-F2BC08E0-3C84-305B-B532-B47331E39A13/GUID-4F4B5CDE-0E48-39CE-B16A-ED2199B849BB"><apiname>CMobilePhoneListbase::AddEntryL()</apiname></xref> to add a new
entry to the list. </info>
</step>
<step id="GUID-4453D40E-97F4-58C2-A31B-49E85F5708B8"><cmd/>
<info>Use <xref href="GUID-7DAA54B1-8CE3-3BFD-B554-233FE2B903F0.dita#GUID-7DAA54B1-8CE3-3BFD-B554-233FE2B903F0/GUID-7584BC56-ED9E-3276-AA70-61814421CE08"><apiname>CMobilePhoneEditableListbase::InsertEntryL()</apiname></xref> to
insert a new entry in the list. </info>
</step>
<step id="GUID-326439BC-8F6F-572B-926B-69934B7B1D92"><cmd/>
<info>Use <xref href="GUID-F2BC08E0-3C84-305B-B532-B47331E39A13.dita#GUID-F2BC08E0-3C84-305B-B532-B47331E39A13/GUID-B1341ACF-780A-3CD5-9D87-49D12CADCE6E"><apiname>CMobilePhoneListbase::GetEntryL()</apiname></xref> to retrieve
an entry from the list. </info>
</step>
<step id="GUID-F5E9E5F7-B072-5D39-A98D-36BC42293472"><cmd/>
<info>Use <xref href="GUID-79558C0C-14B6-3A5F-A5B4-BCC4D496AC89.dita#GUID-79558C0C-14B6-3A5F-A5B4-BCC4D496AC89/GUID-49108F23-A6F5-31C9-A8C4-C01211A0AE15"><apiname>CMobilePhoneEditableList::ChangeEntryL()</apiname></xref> to change
the data of an entry in the list. </info>
</step>
<step id="GUID-E5A49FDD-F2A7-5063-B7D1-DE07D0C0F901"><cmd/>
<info>Do one of the following: </info>

<substeps id="GUID-7CA8605F-B61C-528B-A08A-55851E00A340">
<substep id="GUID-A9A3D15E-627D-51F9-BA89-7A8B9EF58C2A"><cmd/>
<info>Use <xref href="GUID-F2BC08E0-3C84-305B-B532-B47331E39A13.dita#GUID-F2BC08E0-3C84-305B-B532-B47331E39A13/GUID-5522719F-FDF1-3C6C-A1A4-C645B374724B"><apiname>CMobilePhoneListbase::StoreL()</apiname></xref> or <xref href="GUID-F2BC08E0-3C84-305B-B532-B47331E39A13.dita#GUID-F2BC08E0-3C84-305B-B532-B47331E39A13/GUID-D72E251B-3DCE-37A8-8C0F-BE0537496B58"><apiname>CMobilePhoneListbase::StoreLC()</apiname></xref> to
store the data of a list in a stream. </info>
</substep>
<substep id="GUID-6825E7FF-A7B6-576A-AB4F-0E7102ED3833"><cmd/>
<info>Use <xref href="GUID-F2BC08E0-3C84-305B-B532-B47331E39A13.dita#GUID-F2BC08E0-3C84-305B-B532-B47331E39A13/GUID-8D1DEE56-160A-3853-9827-C58DE11F28FA"><apiname>CMobilePhoneListbase::RestoreL()</apiname></xref> to restore the
list from the stream. </info>
</substep>
</substeps>
</step>
<step id="GUID-817B0D42-8A42-5506-90A3-582ABD6080F7"><cmd/>
<info>Use <xref href="GUID-7DAA54B1-8CE3-3BFD-B554-233FE2B903F0.dita#GUID-7DAA54B1-8CE3-3BFD-B554-233FE2B903F0/GUID-399AC999-20AD-3D0E-A0A0-921CB4E4FF55"><apiname>CMobilePhoneEditableListbase::DeleteEntryL()</apiname></xref> to
delete an entry from the list. </info>
</step>
</steps>
</taskbody></task>