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