<?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-BFA9C72B-F50E-5DE1-8DFB-09AF188B2E65" xml:lang="en"><title>Root
Server Tutorial</title><shortdesc>The root session provides access to system telephony information,
in particular the available phones and Telephony System Plug-ins (TSYs). The
root session interface is provided by the <codeph>RTelServer</codeph>. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
<prereq id="GUID-B7297087-0F14-49B8-9CCF-E3EA0CD94EF0"><p>The developers must
have knowledge of Symbian platform Client/Server framework. </p> </prereq>
<context id="GUID-D3FDC5A1-E631-45FB-B1B7-833E25BABADE"><p>The client application
that use the telephony functionalities must create a connection to the telephony
server using the <xref href="GUID-4A173538-1CE1-30CC-AFAA-B4F5496274D1.dita"><apiname>RTelServer</apiname></xref> class. </p> </context>
<steps-unordered>
<step id="GUID-2CF97AEF-98A2-580F-B46A-43A4E5C6275C"><cmd>Create a connection
to the telephony server using <xref href="GUID-4A173538-1CE1-30CC-AFAA-B4F5496274D1.dita"><apiname>RTelServer::Connect()</apiname></xref>. </cmd>
</step>
<step id="GUID-0882226F-4810-5E60-A9FC-93405AFEB962"><cmd>To get the information
of a specific phone session, call the <xref href="GUID-4A173538-1CE1-30CC-AFAA-B4F5496274D1.dita"><apiname>GetPhoneInfo()</apiname></xref> function. </cmd>
</step>
<step id="GUID-8519021F-035B-58CF-B44A-2B7D6EDF97C9"><cmd>To get the TSY name
related to a phone, call the <xref href="GUID-4A173538-1CE1-30CC-AFAA-B4F5496274D1.dita"><apiname>GetTsyName()</apiname></xref> function. </cmd>
</step>
<step id="GUID-257357DB-B0EB-5B25-BB58-5761B1C4965F"><cmd>To load a TSY module,
call the <xref href="GUID-4A173538-1CE1-30CC-AFAA-B4F5496274D1.dita"><apiname>LoadPhoneModule()</apiname></xref> function. </cmd>

<info> Note:The caller must know the name of the TSY which can be passed as
an argument, hard coded or obtained from the communication database. </info>
</step>
<step id="GUID-EC619C27-B306-599B-A401-668765E72742"><cmd>To unload a TSY
module, call the <xref href="GUID-4A173538-1CE1-30CC-AFAA-B4F5496274D1.dita"><apiname>UnloadPhoneModule()</apiname></xref> function. </cmd>
</step>
<step id="GUID-886C280C-5070-5311-A02C-2A18E8F6A9C4"><cmd>To find out if a
functionality is supported by the TSY, call the <xref href="GUID-4A173538-1CE1-30CC-AFAA-B4F5496274D1.dita"><apiname>IsSupportedByModule()</apiname></xref> function. </cmd>

<info>The functionality to be tested is passed as the parameter. </info>
</step>
<step id="GUID-54407495-2451-5114-8785-5A547995B62F"><cmd>To find the version
number of a TSY, call the <xref href="GUID-4A173538-1CE1-30CC-AFAA-B4F5496274D1.dita"><apiname>GetTsyVersionNumber()</apiname></xref> function. </cmd>

<info>Specify the TSY in the function parameter. </info>
</step>
<step id="GUID-EDEA5932-A20A-53C6-9BFD-016BA94660B4"><cmd>To specify the error
granualarity, call the <xref href="GUID-4A173538-1CE1-30CC-AFAA-B4F5496274D1.dita"><apiname>SetExtendedErrorGranualirity()</apiname></xref> function. </cmd>

<info>The default level is set to receive server and system wide error codes.
The extended error codes provide more device specific information. If the
TSY cannot translate the extended error codes then the basic error code is
returned. </info>
</step>
<step id="GUID-E7B4B05A-28C4-5DB2-B00D-26EA70ED320C"><cmd>To set a high priority
to a client, call the <xref href="GUID-4A173538-1CE1-30CC-AFAA-B4F5496274D1.dita"><apiname>SetPriorityClient()</apiname></xref> function. </cmd>
</step>
</steps-unordered>
<postreq id="GUID-1B7118CD-50AB-41E5-9C64-D18ABEB06F6C"><p>To use the functions
specific to phone, line or call use the sub-session classes <xref href="GUID-4A173538-1CE1-30CC-AFAA-B4F5496274D1.dita"><apiname>RPhone</apiname></xref>, <xref href="GUID-4A173538-1CE1-30CC-AFAA-B4F5496274D1.dita"><apiname>RLine</apiname></xref> and <xref href="GUID-4A173538-1CE1-30CC-AFAA-B4F5496274D1.dita"><apiname>RCall</apiname></xref> sub-session
classes. </p> </postreq>
</taskbody><related-links>
<link href="GUID-24D47C0C-733B-5FF6-821E-D280EF526026.dita"><linktext>Phone Sub-session
                Tutorial</linktext></link>
<link href="GUID-2BB64CFC-F564-5DFA-AFEC-DC1760A87662.dita"><linktext>Line Sub-session
Tutorial</linktext></link>
<link href="GUID-B467D117-6670-5614-9886-539CF654F9D8.dita"><linktext>Call Sub-session
Tutorial</linktext></link>
</related-links></task>