<?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-D024ACD7-98E0-51D7-9345-8E0224D2CF02" xml:lang="en"><title>Overriding

the SMTP Mobility Account Settings </title><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>This tutorial explains how to override an SMTP mobility account setting

for per-bearer-type. </p>

<section><title>Introduction</title> <p>The <xref href="GUID-72BF08A4-2724-3F42-A685-F97F68133B69.dita"><apiname>TSmtpMobilityAccount</apiname></xref> and <xref href="GUID-AA86050B-00E4-3EEC-9E41-32C1A4493D30.dita"><apiname>CImSmtpMobilitySettings</apiname></xref> class

are used to override the SMTP mobility account settings. The <xref href="GUID-72BF08A4-2724-3F42-A685-F97F68133B69.dita"><apiname>TSmtpMobilityAccount</apiname></xref> class

encapsulates the name of the mobility account, and associates with a parent

SMTP account; that is, the SMTP account that is to be overridden. This is

associated with an array of IAPs for which this mobility account should be

used. Finally, the settings for the mobility account are stored, and are recoverable

as a <xref href="GUID-AA86050B-00E4-3EEC-9E41-32C1A4493D30.dita"><apiname>CImSmtpMobilitySettings</apiname></xref> class. </p> </section>

<section><title>Procedure</title><p>You can override an SMTP mobility account

setting for per-bearer-type in the following ways:</p><p><b>Method 1</b></p><p>Creating

an SMTP mobility account with settings to be used for specified IAPs, and

associate this with an existing SMTP account. To do this, complete the following

steps:</p><ol>

<li id="GUID-246AF581-C062-4F78-826E-1105329FD457"><p>Create an instance of theCEmailAccounts class.</p></li>

<li id="GUID-9E38C747-0F0F-4E17-9698-81DCC82CED19"><p>Use the <codeph>CEmailAccounts::GetSmtpAccountL()</codeph> function,

to get the ID of the SMTP account for the mobility account used.</p></li>

<li id="GUID-1B592D5F-0157-4660-B02C-6581DFB00816"><p>Create an instance of the<codeph> CImSmtpMobilitySettings</codeph> class,

and populate according appropriately for the remote server settings.</p></li>

<li id="GUID-BB99DFD6-F2FA-4D68-B582-A3A6753CA0B0"><p>Use the <codeph>CEmailAccounts::PopulateDefaultSmtpMobilitySettingsL()</codeph> function

to populate the remote server settings, for example, server name, login, port,

email address, password, SMTP authentication, and so on. </p></li>

<li id="GUID-95725178-F546-4D1A-BDA3-D4CF0A0FB92D"><p>Create an instance of the <codeph>RArrayIAP</codeph> class, and populate

it with bearer access point IDs for the mobility account shall be used. </p></li>

<li id="GUID-F1287F2F-A405-4460-9134-CAC4CEE115F3"><p>Create a mobility account in the central repository using the following

function:</p><codeblock xml:space="preserve">CEmailAccounts::(const TDesC&amp;, const RArrayIAP&amp;, const TSmtpAccount&amp;, const CImSmtpMobilitySettings&amp;, TBool)</codeblock></li>

</ol><p><b>Method 2</b></p><p>Creating an SMTP mobility account with settings

linked to an existing SMTP account (account A) to be used for specified IAPs,

and associate this with an SMTP account (account B). To do this, complete

the following steps: </p><ol>

<li id="GUID-B3E70737-086B-4AA4-B54D-26291230ACC3"><p>Create an instance of the <codeph>CEmailAccounts</codeph> class. </p></li>

<li id="GUID-CDE75329-5DA9-48C0-B136-0D15431B54B7"><p>Using the <codeph>CEmailAccounts::GetSmtpAccountL()</codeph> function,

obtain the ID of the SMTP account to which the SMTP mobility account’s settings

are to be linked (account A). </p></li>

<li id="GUID-1BBABC30-0A59-4F0E-8322-31C421C4865D"><p>Use the <codeph>CEmailAccounts::GetSmtpAccountL()</codeph> function,

to get the ID of the SMTP account for which the SMTP mobility account overrides

the default account settings for specified IAPs (account B).</p></li>

<li id="GUID-61F3E224-A98D-4AA1-9808-CE026174D56E"><p>Create an instance of the <codeph>RArrayIAP</codeph> class, and populate

with bearer access point IDs for the mobility account. </p></li>

<li id="GUID-20737DE1-E55B-4FD1-9ED7-A4A53B752D0B"><p>Create the mobility account in the central repository using the following

function: </p><codeblock xml:space="preserve">CEmailAccounts::CreateSmtpMobilityAccountL(const TDesC&amp;, const RArrayIAP&amp;, const TSmtpAccount&amp;, const TSmtpAccount&amp; aLinkedSmtpAccount, TBool)</codeblock></li>

</ol></section>

<section><title>See also</title> <p> <xref href="GUID-24860917-0FE2-5C8F-B436-96928350996E.dita">Bearer

Mobility Overview</xref>  </p> </section>