<?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-88FDEE3B-83DF-5635-92FC-CF291D1D6C2D" xml:lang="en"><title>Removing

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

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

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

SSL sockets. </p>

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

<li id="GUID-C6466767-1C20-5674-8455-237932912224"><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-67966B2C-6DBA-5DBC-8D3B-5F2B477AA45F"><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-85A6F2B3-EE43-56AB-8A44-AE4A9B10EF59"><p>Create an instance of

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

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

<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

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

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

<li id="GUID-12E99608-E016-5BD3-8F4E-AA3E25B564E2"><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>