Symbian3/SDK/Source/GUID-BB6C60B4-9D34-5AC0-A4FD-3B604A35B8BD.dita
author Dominic Pinkman <dominic.pinkman@nokia.com>
Tue, 20 Jul 2010 12:00:49 +0100
changeset 13 48780e181b38
parent 0 89d6a7a84779
permissions -rw-r--r--
Week 28 contribution of SDK documentation content. See release notes for details. Fixes bugs Bug 1897 and Bug 1522.

<?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 concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-BB6C60B4-9D34-5AC0-A4FD-3B604A35B8BD" xml:lang="en"><title>Enabling
the Bearer Mobility</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>This tutorial explains how to enable the bearer mobility for an email account. </p>

<section><title>Required background</title> <p>Bearer mobility is possible
only on the connections that are established using a SNAP preference list.
See <xref href="GUID-24860917-0FE2-5C8F-B436-96928350996E.dita#GUID-24860917-0FE2-5C8F-B436-96928350996E/GUID-24BF7108-9229-5F0D-A3B0-27A8E419ABFF">Important
considerations</xref> before enabling the non-seamless bearer mobility. </p> </section>
<section><title>Procedure</title> <ol id="GUID-33FDAF89-19E8-59E5-8974-D000B18BE61D">
<li id="GUID-2C19A596-9FAE-588F-A2BC-2BE1BEF9C812"><p>Create an instance of
the <xref href="GUID-A7EF08E6-82AF-3577-B942-ABD532EDB7FE.dita"><apiname>CEmailAccounts</apiname></xref> class. </p> </li>
<li id="GUID-D576D44D-C006-527F-B9BC-9D518C9B94FE"><p>Create an instance of
the <xref href="GUID-9CAB9BE5-7233-3A01-A906-756177CF4460.dita"><apiname>CImIAPPreferences</apiname></xref> class to be used by the email service. </p> </li>
<li id="GUID-487865ED-E636-5724-B13A-1DDBBAD1AFE9"><p>Create an instance of
the <codeph>CIm&lt;protocol&gt;Settings</codeph> class. </p> <p>Where, &lt;protocol&gt;
is either Imap4, Pop3, or Smtp. </p> </li>
<li id="GUID-A1118650-157A-530B-B724-145BCB23A865"><p>Populate the <xref href="GUID-9CAB9BE5-7233-3A01-A906-756177CF4460.dita"><apiname>CImIAPPreferences</apiname></xref> class
and the <codeph>CIm&lt;protocol&gt;Settings</codeph> class from central repository
(CenRep) using <xref href="GUID-A7EF08E6-82AF-3577-B942-ABD532EDB7FE.dita"><apiname>CEmailAccounts</apiname></xref> <codeph>::Load&lt;protocol&gt;IapSettingsL</codeph> function. </p> </li>
<li id="GUID-B9239A82-DC25-5A91-BCDB-BF8BDD2710A1"><p>Use the <codeph>CIm&lt;protocol&gt;Settings::</codeph> <xref href="GUID-7E4A95AA-1614-3058-B08C-B81878C37489.dita"><apiname>SetBearerMobility</apiname></xref> function
to set the <xref href="GUID-4B942C06-1BAC-3A21-B3B1-89FB5C51ADA0.dita"><apiname>TBool</apiname></xref> parameter to <codeph>ETrue</codeph>. </p> </li>
<li id="GUID-ADB56EA1-FE9C-5C2F-875F-F12F4BFE94CD"><p>Store the updated settings
classes to CenRep using the <xref href="GUID-A7EF08E6-82AF-3577-B942-ABD532EDB7FE.dita"><apiname>CEmailAccounts</apiname></xref> <codeph>::Save&lt;protocol&gt;IapSettingsL</codeph> function. </p> </li>
</ol> <note> All instances of &lt;protocol&gt; in the preceding steps are either <codeph>Imap4</codeph>, <codeph>Pop3</codeph>,
or<codeph> Smtp</codeph>.</note></section>
<section><title>See also</title> <p><xref href="GUID-24860917-0FE2-5C8F-B436-96928350996E.dita">Bearer
Mobility Overview</xref>  </p> </section>
</conbody></concept>