Symbian3/PDK/Source/GUID-6D1DEAA7-59BB-5A5B-9E5F-8383E017F8C0.dita
changeset 5 f345bda72bc4
parent 3 46218c8b8afa
child 14 578be2adaf3e
--- a/Symbian3/PDK/Source/GUID-6D1DEAA7-59BB-5A5B-9E5F-8383E017F8C0.dita	Tue Mar 30 11:42:04 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-6D1DEAA7-59BB-5A5B-9E5F-8383E017F8C0.dita	Tue Mar 30 11:56:28 2010 +0100
@@ -1,23 +1,54 @@
-<?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>
\ No newline at end of file
+<?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>
\ No newline at end of file