<?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>


</taskbody></task>