Documentation  |   Table of Contents   |  < Previous   |  Next >   |  Index

1    Telephony Service Types

Telephony and SMS

Exploring Palm OS®

The telephony API organizes functions within sets called service sets. Each service set contains a related set of functions that may or may not be available on a particular mobile device or network. You should use the TelIsServiceAvailable() function to determine if a service set is supported in the current environment, and you should use the TelIsFunctionSupported() function to determine if a specific function is supported in the current environment.


NOTE: Sometimes a service set is supported, but not all of the functions in that service set are supported. See Testing the Telephony Environment for more information.

Each function in the telephony API is prefixed with Tel; each telephony service set adds an additional 3 characters to the prefix. Table 1.1 describes the telephony service sets.

Table 1.1  Telephony API service sets 

Service set

Functionality

Service prefix

Basic

Basic functions that are always available.

Tel

Configuration

Services that allow you to configure phones, including SMS configuration.

TelCfg

Emergency calls

Emergency call handling.

TelEmc

Information

Functions to retrieve information about the current phone.

TelInf

Network

Functions the provide network-oriented services, including authorized networks, current network, signal level, and search mode information.

TelNwk

OEM

A function that allows hardware manufacturers to extend the Telephony Manager. Each manufacturer can provide a specific set of OEM functions for a particular device.

TelOem

Phone book

Functions to access the phone's SIM and address book, including the ability to create, view, and delete phone book entries.

TelPhb

Power

Power supply related functions.

TelPow

Security

Functions that provide PIN code management and related services for phone and SIM security-related features.

TelSty

Short Message Service

Services to handle Short Message Service (SMS) and to enable the reading, sending, and deleting of short messages.

TelSms

Sound

Phone sound management related to muting.

TelSnd

Speech calls

Functions to handle the sending and receiving of speech calls. This service also includes functions that handle playing DTMF tones.

TelSpc