<?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-2BB64CFC-F564-5DFA-AFEC-DC1760A87662" xml:lang="en"><title>Line

Sub-session Tutorial</title><prolog><metadata><keywords/></metadata></prolog><taskbody>

<context><p>A phone can have one or more lines. Similarly to the phone, Clients

can access the status and capabilities of a line, and can be notified if these

 change. </p><p>The line interface is provided by <xref href="GUID-BE14DF7D-5BC4-3549-8FEE-CFDBA9A54ABF.dita"><apiname>RLine</apiname></xref> class. </p><p>This

section describes the Line sub-session functions and how they are used. </p><table id="GUID-ECACBD5C-1E16-4C70-816D-B58C6FD9B54C">

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

<thead>

<row>

<entry>Function</entry>

<entry>Description</entry>

</row>

</thead>

<tbody>

<row>

<entry><p>                  <xref href="GUID-02EDAC3A-38FA-355C-B4CC-B2D9A63191B3.dita"><apiname>OpenNewCall()</apiname></xref>             

   </p> </entry>

<entry><p>                  Call this function to create a new call session.

The call can be                  created in a server, phone or a line sub-session.

                </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-56562802-D47E-3EE9-8FDF-0DADD094A007.dita"><apiname>OpenExistingCall()</apiname></xref>        

        </p> </entry>

<entry><p>                  Call this function to open an existing call. 

               </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-329D26DB-D4B1-36BF-A82A-93A3B8964738.dita"><apiname>GetStatus()</apiname></xref>               

 </p> </entry>

<entry><p>                  Call this function to get the status of a call

sub-session.                 </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-5720D739-F903-395C-90F4-D0E3225DE560.dita"><apiname>GetCaps()</apiname></xref>                 </p> </entry>

<entry><p>                  Call this function to get the capabilities of

a call sub-session.                                  </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-332BD561-CB6C-3140-A621-083E1A2F5863.dita"><apiname>NotifyCapsChange()</apiname></xref>        

        </p> </entry>

<entry><p>                  Call this function to receive notification of

capability changes.                                  </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-CE107F43-3A7B-3E51-B767-F94FD913F035.dita"><apiname>NotifyCapsChangeCancel()</apiname></xref>  

              </p> </entry>

<entry><p>                  Call this function to cancel an earlier request.

                </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-942B368A-AE4A-3A27-86A7-9CB97BDACFF9.dita"><apiname>GetBearerServiceInfo()</apiname></xref>    

            </p> </entry>

<entry><p>                  Call this function to get the bearer information

of an active                  call.                 </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-66D96ADA-1C26-3293-9F92-FD65E08D6158.dita"><apiname>GetInfo()</apiname></xref>                 </p> </entry>

<entry><p>                  Call this function to get the information of the

current call                  sub-session.                 </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-951E5916-B29E-300D-91A1-CA7F3E125369.dita"><apiname>NotifyHookChange()</apiname></xref>        

        </p> </entry>

<entry><p>                  Call this function to receive information about

a hook associated                  with the call sub-session.            

    </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-E24430E7-C045-3307-9DBE-0D1043270BAE.dita"><apiname>NotifyHookChangeCancel()</apiname></xref>  

              </p> </entry>

<entry><p>                  Call this function to cancel an earlier request.

                </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-FDC39733-AB7E-35B9-95A7-79859C6C4BFC.dita"><apiname>NotifyStatusChange()</apiname></xref>      

          </p> </entry>

<entry><p>                  Call this function to get the information about

the status                  changes of a call sub-session.               

 </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-919FEB0C-4241-3D22-BC9A-7EC25CA01731.dita"><apiname>NotifyStatusChangeCancel()</apiname></xref> 

               </p> </entry>

<entry><p>                  Call this function to cancel an earlier request.

                </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-33200C13-6078-3B3A-B7CA-17D81DDACF87.dita"><apiname>GetCallDuration()</apiname></xref>         

       </p> </entry>

<entry><p>                  Call this function to get the information about

a call duration.                 </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-FF20DBE3-AC3C-3D43-90DD-77B8240C56C3.dita"><apiname>Dial()</apiname></xref>                 </p> </entry>

<entry><p>                  Call this function to establish a connection to

a specified                  number, call the function with telephone number.

                </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-408D4D7E-FCD1-3ECF-AD62-6DA52E9580F5.dita"><apiname>Connect()</apiname></xref>                 </p> </entry>

<entry><p>                  Call this function to establish a connection to

a remote modem,                  call the function specifying the address

of the remote modem.                 </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-EE55DE46-8389-3D59-8EE0-2EBDDDD6A9BD.dita"><apiname>AnswerIncomingCall()</apiname></xref>      

          </p> </entry>

<entry><p>                  Call this function to answer an incoming call.

                </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-75166D44-93EB-3F21-98A3-86C3E86076E9.dita"><apiname>HangUp()</apiname></xref>                 </p> </entry>

<entry><p>                  Call this function to terminate a call connection.

                </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-0E413877-D699-3C5E-BD2A-CB2BACA66B2E.dita"><apiname>LoanDataPort()</apiname></xref>            

    </p> </entry>

<entry><p>                  Call this function to gain control of a serial

modem. To return                  the port conection of the serial communication,

call the<xref href="GUID-C79484B5-49B5-3870-BCBB-D696D4D19062.dita"><apiname>                  RecoverDataPort()</apiname></xref> function. 

               </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-2A652EAF-A124-3584-8231-B1EB2099D12D.dita"><apiname>TransferOwnership()</apiname></xref>       

         </p> </entry>

<entry><p>                  Call this function to transfer the ownership of

a call to another                  client.                 </p> <p>      

           The other client must call                  <xref href="GUID-3CEBC917-0C11-3EC6-914F-5007DF647F61.dita"><apiname>AcquireOwenership()</apiname></xref> function.

                </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-E7212BD7-E940-352B-9849-2A0DA7A6F242.dita"><apiname>GetOwnershipStatus()</apiname></xref>      

          </p> </entry>

<entry><p>                  Call this function to get the ownership information

of a call                  sub-session.                 </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-5818D914-7F83-3DB9-97CD-29F38F932788.dita"><apiname>GetCallParams()</apiname></xref>           

     </p> </entry>

<entry><p>                  Call this function to find out the parameters

associated with the                  current call sub-session.           

     </p> </entry>

</row>

<row>

<entry><p>                  <xref href="GUID-EE548428-9B48-3AB4-BC91-C37641A6E5FD.dita"><apiname>GetFaxSettings()</apiname></xref>          

      </p> </entry>

<entry><p>                  Call this function to get the fax settings of

a call sub-session.                  To set the fax settings call the <xref href="GUID-B7BAB6DE-7883-3BA1-8C51-79BC4A0C3DA0.dita"><apiname>SetFaxSettings()</apiname></xref> function.

                </p> </entry>

</row>

</tbody>

</tgroup>

</table></context>