<?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 &amp; RMobilePhone::KCapsNotifyCFStatus)
    {
        //do something
    }

</codeblock> </example>
</taskbody></task>