<?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-8285AA78-1CF6-56A1-9DBA-78EFBBE9B32D" xml:lang="en"><title>Call

Supplementary Services Tutorial</title><shortdesc>This tutorial describes how to retrieve the call supplementary

services capability of a device. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<context><p> A number of supplementary services for call management

like call  forwarding and call barring are available in both GSM and CDMA

networks. </p><p>The high level steps to retrievecall supplementary services

are shown  here: </p></context>

<steps id="GUID-C04ECDCC-5689-5E1D-BA0A-BC969A785519">

<step id="GUID-D13DF176-A28A-56BE-A539-4317C0194401"><cmd>To find the services

that are supported, use <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::GetCallServiceCaps()</apiname></xref>. </cmd>

</step>

<step id="GUID-9341CCF2-DBD5-5971-ABE3-4D31FCCD83F0"><cmd>Notify the Clients

of any changes in the services using <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::NotifyCallServiceCapsChange()</apiname></xref>. </cmd>

</step>

</steps>

<result><p>Possible services are described in the <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone::TMobilePhoneCallServiceCaps</apiname></xref> enum. </p> </result>

<example><title>Get supplementary capability example</title> <p>The following

code gets the supplementary call services capabilities and checks if notification

of status changes of any call forwarding service is supported. The code assumes <codeph>iMobilePhone</codeph> is

an <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone</apiname></xref> object. </p> <p> </p> <codeblock id="GUID-E9D79E88-D36B-519C-8216-E2815D0D5B12" xml:space="preserve">TUint32 csCaps;

User::LeaveIfError(iMobilePhone.GetCallServiceCaps(csCaps));

if (csCaps & RMobilePhone::KCapsNotifyCFStatus)

    {

        //do something

    }

</codeblock> </example>

</taskbody></task>