<?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 xml:lang="en" id="GUID-6D1DEAA7-59BB-5A5B-9E5F-8383E017F8C0"><title>Caller Identity Services Tutorial</title><shortdesc>This tutorial describes how to implement the caller identity services in a Symbian OS device. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody> <context><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><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>