Symbian3/PDK/Source/GUID-8285AA78-1CF6-56A1-9DBA-78EFBBE9B32D.dita
changeset 1 25a17d01db0c
child 3 46218c8b8afa
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/PDK/Source/GUID-8285AA78-1CF6-56A1-9DBA-78EFBBE9B32D.dita	Fri Jan 22 18:26:19 2010 +0000
@@ -0,0 +1,43 @@
+<?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>
\ No newline at end of file