<?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-0DA6722B-0700-5612-884A-F3B7733E5252" xml:lang="en"><title>Voice

Line Status Tutorial</title><shortdesc>This tutorial describes how to get the voice line status with the

telephony API for applications. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<context id="GUID-BAC8D4B3-FAB2-4EE9-B20F-41810AEBD84E"><p>The <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita"><apiname>CTelephony</apiname></xref> functions provide a detailed

 information on the voice line status. The detailed call information provides

 the information about: </p><ul>

<li><p>call status  </p></li>

<li><p> date of the call  </p></li>

<li><p> time of the call  </p></li>

<li><p> duration of the call  </p></li>

<li><p>destination number  </p></li>

<li><p>caller identification  </p></li>

<li><p>dynamic call capabilities  </p></li>

</ul></context>

<steps id="GUID-F9E13043-8D2A-57BC-B9C0-ADD51F3AA449">

<step id="GUID-7BA25A70-5F62-5668-8A64-D5F90FD72504"><cmd>create a new instance

of <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita"><apiname>CTelephony</apiname></xref>  </cmd>

</step>

<step id="GUID-382DD7F5-8555-5B06-9596-08D1C4684714"><cmd>use <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita"><apiname>CTelephony::GetLineStatus()</apiname></xref> to

get the simple voice line status</cmd>

</step>

<step id="GUID-2B2692FB-88FF-5F40-8FC0-A30D7146C757"><cmd>use <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita"><apiname>CTelephony::GetCallStatus()</apiname></xref> to

get the status of any voice call owned by the client application </cmd>

</step>

<step id="GUID-C46FB87F-B7FB-5347-9199-D27CA9634E6F"><cmd>use <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita"><apiname>CTelephony::GetCallInfo()</apiname></xref> to

get the detailed call information about the call </cmd>

<info>pass the following parameters for the required information </info>

<stepxmp><table id="GUID-9FDDE4F7-130C-55C9-8205-CF8C96575665">

<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>

<thead>

<row>

<entry>Parameter</entry>

<entry>Function</entry>

</row>

</thead>

<tbody>

<row>

<entry><p>TCallStatus </p> </entry>

<entry><p>To get the status of a call like idle, on-hold, dialling and ringing </p> </entry>

</row>

<row>

<entry><p>TDateTime </p> </entry>

<entry><p>To get the data and time of a call </p> </entry>

</row>

<row>

<entry><p>TTimeIntervalSeconds </p> </entry>

<entry><p>To get the duration of a call </p> </entry>

</row>

<row>

<entry><p>TTelAddress </p> </entry>

<entry><p>To get the destination number </p> </entry>

</row>

<row>

<entry><p>TPhoneNetworkSecurity </p> </entry>

<entry><p>To get the ciphering information from the network </p> </entry>

</row>

<row>

<entry><p>TCallRemoteIdentityStatus </p> </entry>

<entry><p>To determine if the remote caller status is available </p> </entry>

</row>

<row>

<entry><p>TCallDirection </p> </entry>

<entry><p>To determine the call direction </p> </entry>

</row>

</tbody>

</tgroup>

</table> </stepxmp>

</step>

<step id="GUID-0604B8F5-98CA-57B1-98D9-2B91708CF29C"><cmd>use <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita"><apiname>GetCallDynamicCaps()</apiname></xref> to

get the dynamic capability information about the call.</cmd>

</step>

</steps>

<example id="GUID-6F8987BC-703D-549F-85F7-11BDB3EAC319"><title>Voice call

information example</title> <p>The example code describes the steps to get

the detailed call information. </p> <codeblock id="GUID-5B4EF60C-66A0-5862-9E72-6759532AC776" xml:space="preserve">CTelephony* telephony = CTelephony::NewLC();

CTelephony::TCallInfoV1 callInfoV1;

CTelephony::TCallInfoV1Pckg callInfoV1Pckg( callInfoV1 );

CTelephony::TCallSelectionV1 callSelectionV1;

CTelephony::TCallSelectionV1Pckg callSelectionV1Pckg( callSelectionV1 );

CTelephony::TRemotePartyInfoV1 remotePartyInfoV1;

CTelephony::TRemotePartyInfoV1Pckg remotePartyInfoV1Pckg( remotePartyInfoV1  );

callSelectionV1.iLine = CTelephony::EVoiceLine;

callSelectionV1.iSelect = CTelephony::EActiveCall;

telephony->GetCallInfo( callSelectionV1Pckg, callInfoV1Pckg, remotePartyInfoV1Pckg );

CleanupStack::PopAndDestroy( telephony );</codeblock> </example>

<postreq id="GUID-3A6FA503-E4A8-5013-A155-E8F80844281B"><p>The example code

to get the dynamic call capability information </p> <codeblock id="GUID-53DB7E1D-B6FA-5497-9140-28EB10EF242C" xml:space="preserve">CTelephony::TCallCapsV1 callCapsV1;

CTelephony::TCallCapsV1Pckg callCapsV1Pckg( callCapsV1 );

telephony->GetCallDynamicCaps( callId, callCapsV1Pckg );

TUint32 caps = callCapsV1.iControlCaps;

if( caps & CTelephony::KCapsHold )

   {} // The call represented by 'callId' can be put on hold</codeblock> </postreq>