The Network Information API provides functions to obtain information about the current telephony service network.
Required Header
#include <telephony.h>
Overview
The Telephony Network Information API allows you to access, but not change the information about the current cellular network and telephony service.
Related Features
This API is related with the following feature:
It is recommended to design feature related codes in your application for reliability.
You can check if a device supports the related features for this API by using System Information, thereby controlling the procedure of your application.
To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.
More details on featuring your application can be found from Feature List.
Enumeration Type Documentation
Enumeration for RSSI (Receive Signal Strength Indicator).
TELEPHONY_NETWORK_RSSI_6 indicates the highest strength.
- Since :
- 2.3.1
- Enumerator:
TELEPHONY_NETWORK_RSSI_0 |
Strength 0
|
TELEPHONY_NETWORK_RSSI_1 |
Strength 1
|
TELEPHONY_NETWORK_RSSI_2 |
Strength 2
|
TELEPHONY_NETWORK_RSSI_3 |
Strength 3
|
TELEPHONY_NETWORK_RSSI_4 |
Strength 4
|
TELEPHONY_NETWORK_RSSI_5 |
Strength 5
|
TELEPHONY_NETWORK_RSSI_6 |
Strength 6
|
Enumeration for Network Service State.
- Since :
- 2.3.1
- Enumerator:
TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE |
In service
|
TELEPHONY_NETWORK_SERVICE_STATE_OUT_OF_SERVICE |
Out of service
|
TELEPHONY_NETWORK_SERVICE_STATE_EMERGENCY_ONLY |
Only emergency call is allowed
|
Enumeration for Network Type.
- Since :
- 2.3.1
- Enumerator:
TELEPHONY_NETWORK_TYPE_UNKNOWN |
Unknown
|
TELEPHONY_NETWORK_TYPE_GSM |
2G GSM network type
|
TELEPHONY_NETWORK_TYPE_GPRS |
2.5G GPRS network type
|
TELEPHONY_NETWORK_TYPE_EDGE |
2.5G EDGE network type
|
TELEPHONY_NETWORK_TYPE_UMTS |
3G UMTS network type
|
TELEPHONY_NETWORK_TYPE_HSDPA |
HSDPA network type
|
TELEPHONY_NETWORK_TYPE_LTE |
LTE network type
|
Function Documentation
Gets the MCC (Mobile Country Code) of the current registered network.
- Since :
- 2.3.1
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/telephony
- Parameters:
-
[in] | handle | The handle from telephony_init() |
[out] | mcc | The Mobile Country Code (three digits) Mobile Country Code (MCC) identifies the country where the cell is being used. |
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
- Precondition:
- The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.
- See also:
- telephony_network_get_service_state()
Gets the MNC (Mobile Network Code) of the current registered network.
- Since :
- 2.3.1
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/telephony
- Parameters:
-
[in] | handle | The handle from telephony_init() |
[out] | mnc | The Mobile Network Code (three digits) The Mobile Network Code (MNC) identifies the mobile phone operator and network provider. |
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
- Precondition:
- The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.
- See also:
- telephony_network_get_service_state()
Gets the RSSI (Received Signal Strength Indicator).
- Since :
- 2.3.1
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/telephony
- Parameters:
-
[in] | handle | The handle from telephony_init() |
[out] | rssi | The Received Signal Strength Indicator
Higher the received number, the stronger the signal strength. |
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
- Precondition:
- The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.
- See also:
- telephony_network_get_service_state()
Gets the current network state of the telephony service.
- Since :
- 2.3.1
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/telephony
- Parameters:
-
[in] | handle | The handle from telephony_init() |
[out] | network_service_state | The current network state |
- Returns:
0
on success, otherwise a negative error value
- Return values:
-