--- a/Symbian3/PDK/Source/GUID-771CC444-12CA-5DDE-B93B-EA419971C676.dita Thu Mar 11 15:24:26 2010 +0000
+++ b/Symbian3/PDK/Source/GUID-771CC444-12CA-5DDE-B93B-EA419971C676.dita Thu Mar 11 18:02:22 2010 +0000
@@ -1,22 +1,22 @@
-<?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-771CC444-12CA-5DDE-B93B-EA419971C676"><title>Call Information Tutorial</title><shortdesc>This tutorial describes how to get the call information. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody> <context><p>The <xref href="GUID-370708D3-7A34-3F78-BC6F-9243B50ECF09.dita"><apiname>RMobileCall::GetMobileCallInfo()</apiname></xref> must be used to retrieve the call information. The retrieved information contains : </p> <ul><li id="GUID-F2ED31FC-F2D2-5D91-AE73-1B8491FF8287"><p>a bitmask that specifies which of the optional fields are set in the retrieved information </p> </li> <li id="GUID-B7B032E8-FF46-542B-8BD0-37C84CA0980B"><p>call origination information, such as call name, ID, start time, service </p> </li> <li id="GUID-580592D3-2C4A-5841-B595-48D96F361150"><p>remote party information </p> </li> <li id="GUID-A1A37F74-6FF2-593B-BB60-8E28B3F83F22"><p>call status information and flags </p> </li> </ul> </context> <steps id="GUID-659CF3D3-41FC-54FB-B025-64554B325966"> <step id="GUID-962961F0-F00D-5EF4-8B87-017C2602E2CB"><cmd>Use <xref href="GUID-370708D3-7A34-3F78-BC6F-9243B50ECF09.dita"><apiname>RMobileCall::GetMobileCallInfo()</apiname></xref> to retrieve the call inormation. </cmd> </step> <step id="GUID-B4E87319-E7A0-5A1D-AF59-8A025149445D"><cmd>The above function should return a <xref href="GUID-370708D3-7A34-3F78-BC6F-9243B50ECF09.dita"><apiname>RMobileCall::TMobileCallInfoV1</apiname></xref>. </cmd> </step> <step id="GUID-0D54CA54-9DBD-5211-AB90-4C4233F3AF4A"><cmd>The bit mask of the optional field is returned in <xref href="GUID-370708D3-7A34-3F78-BC6F-9243B50ECF09.dita"><apiname>RMobileCall::TMobileCallInfoFlags</apiname></xref>. </cmd> </step> <step id="GUID-CCE03D34-797C-5AA5-9548-53341A18DB1D"><cmd>The remote party information is returned in <xref href="GUID-370708D3-7A34-3F78-BC6F-9243B50ECF09.dita"><apiname>RMobileCall::TMobileCallRemotePartyInfoV1</apiname></xref>. </cmd> </step> <step id="GUID-F9EDC21F-F22F-5CC6-899C-1F2F78F83ECF"><cmd>Notify the client applications using <xref href="GUID-370708D3-7A34-3F78-BC6F-9243B50ECF09.dita"><apiname>RMobileCall::NotifyRemotePartyInfoChange()</apiname></xref>. </cmd> </step> </steps> <example><title>Call information example</title> <p>The following code gets the identity of a remote party, if it is available: </p> <codeblock id="GUID-CA46D5BB-0BFF-57D4-9EEA-1522B7460EF2" xml:space="preserve">void CClientApp::RemoteInfoL(const RMobileCall& aCall, TBuf<RMobileCall::KCallingNameSize>& aName)
- {
- RMobileCall::TMobileCallRemotePartyInfoV1 remoteInfo;
- RMobileCall::TMobileCallInfoV1 callInfo;
- RMobileCall::TMobileCallInfoV1Pckg callInfoPckg(callInfo);
- User::LeaveIfError(aCall.GetMobileCallInfo(callInfoPckg));
- if (callInfo.iRemoteParty.iRemoteIdStatus == RMobileCall::ERemoteIdentityAvailable)
- {
- aName = callInfo.iRemoteParty.iCallingName;
- }
+<?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-771CC444-12CA-5DDE-B93B-EA419971C676"><title>Call Information Tutorial</title><shortdesc>This tutorial describes how to get the call information. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody> <context><p>The <xref href="GUID-370708D3-7A34-3F78-BC6F-9243B50ECF09.dita"><apiname>RMobileCall::GetMobileCallInfo()</apiname></xref> must be used to retrieve the call information. The retrieved information contains : </p> <ul><li id="GUID-F2ED31FC-F2D2-5D91-AE73-1B8491FF8287"><p>a bitmask that specifies which of the optional fields are set in the retrieved information </p> </li> <li id="GUID-B7B032E8-FF46-542B-8BD0-37C84CA0980B"><p>call origination information, such as call name, ID, start time, service </p> </li> <li id="GUID-580592D3-2C4A-5841-B595-48D96F361150"><p>remote party information </p> </li> <li id="GUID-A1A37F74-6FF2-593B-BB60-8E28B3F83F22"><p>call status information and flags </p> </li> </ul> </context> <steps id="GUID-659CF3D3-41FC-54FB-B025-64554B325966"> <step id="GUID-962961F0-F00D-5EF4-8B87-017C2602E2CB"><cmd>Use <xref href="GUID-370708D3-7A34-3F78-BC6F-9243B50ECF09.dita"><apiname>RMobileCall::GetMobileCallInfo()</apiname></xref> to retrieve the call inormation. </cmd> </step> <step id="GUID-B4E87319-E7A0-5A1D-AF59-8A025149445D"><cmd>The above function should return a <xref href="GUID-370708D3-7A34-3F78-BC6F-9243B50ECF09.dita"><apiname>RMobileCall::TMobileCallInfoV1</apiname></xref>. </cmd> </step> <step id="GUID-0D54CA54-9DBD-5211-AB90-4C4233F3AF4A"><cmd>The bit mask of the optional field is returned in <xref href="GUID-370708D3-7A34-3F78-BC6F-9243B50ECF09.dita"><apiname>RMobileCall::TMobileCallInfoFlags</apiname></xref>. </cmd> </step> <step id="GUID-CCE03D34-797C-5AA5-9548-53341A18DB1D"><cmd>The remote party information is returned in <xref href="GUID-370708D3-7A34-3F78-BC6F-9243B50ECF09.dita"><apiname>RMobileCall::TMobileCallRemotePartyInfoV1</apiname></xref>. </cmd> </step> <step id="GUID-F9EDC21F-F22F-5CC6-899C-1F2F78F83ECF"><cmd>Notify the client applications using <xref href="GUID-370708D3-7A34-3F78-BC6F-9243B50ECF09.dita"><apiname>RMobileCall::NotifyRemotePartyInfoChange()</apiname></xref>. </cmd> </step> </steps> <example><title>Call information example</title> <p>The following code gets the identity of a remote party, if it is available: </p> <codeblock id="GUID-CA46D5BB-0BFF-57D4-9EEA-1522B7460EF2" xml:space="preserve">void CClientApp::RemoteInfoL(const RMobileCall& aCall, TBuf<RMobileCall::KCallingNameSize>& aName)
+ {
+ RMobileCall::TMobileCallRemotePartyInfoV1 remoteInfo;
+ RMobileCall::TMobileCallInfoV1 callInfo;
+ RMobileCall::TMobileCallInfoV1Pckg callInfoPckg(callInfo);
+ User::LeaveIfError(aCall.GetMobileCallInfo(callInfoPckg));
+ if (callInfo.iRemoteParty.iRemoteIdStatus == RMobileCall::ERemoteIdentityAvailable)
+ {
+ aName = callInfo.iRemoteParty.iCallingName;
+ }
}</codeblock> </example> </taskbody></task>
\ No newline at end of file