<?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-6D1DEAA7-59BB-5A5B-9E5F-8383E017F8C0" xml:lang="en"><title>Caller
Identity Services Tutorial</title><shortdesc>This tutorial describes how to implement the caller identity services
in a Symbian platform device. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
<context id="GUID-5BF27706-DD32-46A3-BB81-9EB15912D59A"><p>GSM defines the following supplementary services that display
the identity of the calling or the connected party: </p> <ul>
<li id="GUID-B8EE79F8-E4AA-5994-959B-0C003EC9FBF4"><p>Calling Line Identity
Presentation (CLIP) </p> </li>
<li id="GUID-16A072AE-C8BA-5403-A610-F699F013C6CA"><p>Calling Line Identity
Restriction (CLIR) </p> </li>
<li id="GUID-4979062D-DC26-5C9F-8251-69EC1B33AD1E"><p>Connected Line Identity
Presentation (COLP) </p> </li>
<li id="GUID-AA2417DE-3B39-5033-9E8A-4B09CBB57B7C"><p>Connected Line Identity
Restriction (COLR) </p> </li>
<li id="GUID-2314174B-21A4-5AEF-B2F7-2B453437B626"><p>Calling Name Presentation
(CNAP) </p> </li>
</ul> </context>
<steps-unordered>
<step id="GUID-DEF97BFA-EAFC-535C-A305-A435F6825501"><cmd>To get the status
of an identity service, use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::GetIdentityServiceStatus()</apiname></xref>  </cmd>
</step>
<step id="GUID-8C661856-AFA5-5FB9-8725-140139C92A95"><cmd/>

<info>Possible services are described in the <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneIdService</apiname></xref> enum
and the status values in <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneIdServiceStatus</apiname></xref>. </info>
</step>
</steps-unordered>
<example><title>Caller identity example</title> <p>The following code checks
if the CNAP service is active that is if the name of the caller is shown. </p> <p>The
code assumes <codeph>iMobilePhone</codeph> is an <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone</apiname></xref> object. </p> <codeblock id="GUID-E125D1CE-5491-5408-852D-DB7583EA3FCD" xml:space="preserve">TRequestStatus status;
RMobilePhone::TMobilePhoneIdServiceStatus serviceStatus;

iMobilePhone.GetIdentityServiceStatus(status,RMobilePhone::EIdServiceCallerName, serviceStatus);
User::WaitForRequest(status);
User::LeaveIfError(status.Int());

if (serviceStatus == RMobilePhone::EIdServiceActivePermanent)
    {
        //do something
    }
</codeblock> </example>
<postreq id="GUID-72156EDB-C318-4503-9D52-CEFC3BDC8D32"><p>There are no setter functions for the above described supplementary
services. Contact the service provider to change the service activation. </p> </postreq>
</taskbody></task>