![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Section Contents
Applications that use this class will not work correctly on a version of EPOC earlier than ER5.
RSessionBase |
Abstraction for session base class |
etel.h
etel.lib
The root server session provides access to general telephony information and functionality. Clients wishing to use the ETel Server must open a connection with the root server using the functions defined in this class. They may then obtain information about loaded TSY modules, and the phones that they support. To access functionality associated with a specific phone, the client must open a sub-session for that phone.
This class is not intended for user derivation
RTelServer();
The C++ constructor is empty, and is present only to support virtual function table export: see Implications of static DLLs.
TInt Connect(TInt aMessageSlots = KDefaultMessageSlots);
This function connects the client to the ETel Server. It must be used before any of other functions during a telephony session.
TInt aMessageSlots |
The number of message slots available to this session. |
TInt |
An error code: see System error codes. |
TVersion Version() const;
This function returns the version number of the ETel server.
TVersion |
The server version and build numbers. |
TInt EnumeratePhones(TInt& aIndex) const;
This function retrieves the total number of phones supported by all the currently loaded ETel (TSY) modules.
TInt& aIndex |
On return, contains the total number of phones belonging to the currently loaded modules. |
TInt |
An error code: see System error codes. |
TInt GetPhoneInfo(const TInt aIndex,TPhoneInfo& aInfo) const;
This function retrieves information associated with the specified phone.
const TInt aIndex |
Index of the specified phone. |
TPhoneInfo& aInfo |
On return, contains the phone information. |
TInt |
An error code: see System error codes. |
TInt GetTsyName(const TInt aIndexOfPhone, TDes& aTsyName) const;
This function retrieves the name of the TSY module to which the phone belongs.
const TInt aIndexOfPhone |
Index of the specified phone. |
TDes& aTsyName |
On return, contains the name of the TSY module. |
TInt |
An error code: see System error codes. |
TInt IsSupportedByModule(const TDesC& aTsyName, const TInt aMixin, TBool& aResult) const;
This function allows a client to query a TSY module about what type of extended functionality it supports. It is assumed the TSY module supports all functionality defined in this, the core, API.
const TDesC& aTsyName |
The name of the TSY module. |
const TInt aMixin |
A bitmask of the extended functionality constants. See Extended functionality constants. |
TBool& aResult |
On return, contains the result of the query: TRUE (functionality available) or FALSE (functionality unavailable). |
TInt |
An error code: see System error codes. |
TInt LoadPhoneModule(const TDesC& aFileName) const;
This function loads an ETel TSY module. The name of the TSY to be loaded can be obtained in two ways. Firstly it can be obtained by querying the CommDb for the current TSY see Loading a TSY module. Secondly, users can find TSY names by searching the \System\Libs\
directory for files with the extension tsy
.
const TDesC& aFileName |
The name of the module to be loaded. |
TInt |
An error code: see System error codes. |
TInt UnloadPhoneModule(const TDesC& aFileName) const;
This function unloads an ETel TSY module.
const TDesC& aFileName |
The name of the module to be unloaded. |
TInt |
An error code: see System error codes. |
TInt SetPriorityClient() const;
This function is a request to the server to allocate priority status to the client that calls it. To prevent an out of memory error, the server uses pre-allocated memory to service the requests of priority clients.
TInt |
An error code: see System error codes. |
Default number of message slots = 32 |
Wired analog network. |
|
Wired digital network (not supported by ETel). |
|
Mobile analog network (not supported by ETel). |
|
Mobile digital network. |
|
Unknown network type. |
TNetworkType iNetworkType |
The type of telephony connection supported by the phone. |
TName iName |
The name of the phone. |
TUint iNumberOfLines |
The number of lines supported by the phone. |
TUint iExtensions |
The extensions that the TSY module supports. |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |