--- a/Symbian3/PDK/Source/GUID-6D1DEAA7-59BB-5A5B-9E5F-8383E017F8C0.dita Thu Mar 11 15:24:26 2010 +0000
+++ b/Symbian3/PDK/Source/GUID-6D1DEAA7-59BB-5A5B-9E5F-8383E017F8C0.dita Thu Mar 11 18:02:22 2010 +0000
@@ -1,23 +1,23 @@
-<?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
- }
+<?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