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
|