Root
Server Tutorial
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 RTelServer.
The developers must
have knowledge of Symbian platform Client/Server framework.
The client application
that use the telephony functionalities must create a connection to the telephony
server using the RTelServer class.
- Create a connection
to the telephony server using RTelServer::Connect().
- To get the information
of a specific phone session, call the GetPhoneInfo() function.
- To get the TSY name
related to a phone, call the GetTsyName() function.
- To load a TSY module,
call the LoadPhoneModule() function.
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.
- To unload a TSY
module, call the UnloadPhoneModule() function.
- To find out if a
functionality is supported by the TSY, call the IsSupportedByModule() function.
The functionality to be tested is passed as the parameter.
- To find the version
number of a TSY, call the GetTsyVersionNumber() function.
Specify the TSY in the function parameter.
- To specify the error
granualarity, call the SetExtendedErrorGranualirity() function.
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.
- To set a high priority
to a client, call the SetPriorityClient() function.
To use the functions
specific to phone, line or call use the sub-session classes RPhone, RLine and RCall sub-session
classes.
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.