1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-88FDEE3B-83DF-5635-92FC-CF291D1D6C2D" xml:lang="en"><title>Removing

    13 the Domain Name for Certificate Validation</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>This tutorial explains how to configure an IMAP, POP or SMTP email account

    15 to remove the domain name when connecting to a server using secure TLS or

    16 SSL sockets. </p>

    17 <section><title>Procedure</title> <ol id="GUID-1A664AF6-CED9-5630-99A6-0763A27867B1">

    18 <li id="GUID-C6466767-1C20-5674-8455-237932912224"><p>Create an instance of

    19 the <xref href="GUID-A7EF08E6-82AF-3577-B942-ABD532EDB7FE.dita"><apiname>CEmailAccounts</apiname></xref> class. </p> </li>

    20 <li id="GUID-67966B2C-6DBA-5DBC-8D3B-5F2B477AA45F"><p>Create an instance of

    21 the <xref href="GUID-9CAB9BE5-7233-3A01-A906-756177CF4460.dita"><apiname>CImIAPPreferences</apiname></xref> class to be used by the email service. </p> </li>

    22 <li id="GUID-85A6F2B3-EE43-56AB-8A44-AE4A9B10EF59"><p>Create an instance of

    23 the <codeph>CIm&lt;protocol&gt;Settings</codeph> class. </p> <p>Where, &lt;protocol&gt;

    24 is Imap4, Pop3, or Smtp. </p> </li>

    25 <li id="GUID-77FEF184-F485-5E74-9C4B-8C57D845FC6C"><p>Populate the <xref href="GUID-9CAB9BE5-7233-3A01-A906-756177CF4460.dita"><apiname>CImIAPPreferences</apiname></xref> class

    26 and the <codeph>CIm&lt;protocol&gt;Settings</codeph> class from central repository

    27 (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>

    28 <li id="GUID-F27AF2F3-A4FA-5EE4-B78C-58E5B4BE845C"><p>Use the <codeph>CIm&lt;protocol&gt;Settings::</codeph> <xref href="GUID-86633B7D-5AB8-3BBD-BB54-4697211AC86E.dita"><apiname>SetTlsSslDomainL()</apiname></xref> function

    29 to pass <codeph>KNullDesC8</codeph> to clear the existing domain name. </p> </li>

    30 <li id="GUID-12E99608-E016-5BD3-8F4E-AA3E25B564E2"><p>Store the updated settings

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

    32 </ol> <note> All instances of &lt;protocol&gt; in the preceding steps are either <codeph>Imap4</codeph>, <codeph>Pop3</codeph>,

    33 or <codeph>Smtp</codeph>.</note></section>

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

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

    36 </conbody></concept>