<?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>