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 information about the current cellular network and telephony service, but not to change the information.

Related Features

This API is related with the following feature:

http://tizen.org/feature/network.telephony

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 Element.

Functions
int	telephony_network_get_lac (telephony_h handle, int *lac)
	Gets the LAC (Location Area Code) of the current location.
int	telephony_network_get_cell_id (telephony_h handle, int *cell_id)
	Gets the cell ID of the current location.
int	telephony_network_get_rssi (telephony_h handle, telephony_network_rssi_e *rssi)
	Gets the RSSI (Received Signal Strength Indicator).
int	telephony_network_get_roaming_status (telephony_h handle, bool *status)
	Gets the roaming state of the current registered network.
int	telephony_network_get_mcc (telephony_h handle, char **mcc)
	Gets the MCC (Mobile Country Code) of the current registered network.
int	telephony_network_get_mnc (telephony_h handle, char **mnc)
	Gets the MNC (Mobile Network Code) of the current registered network.
int	telephony_network_get_network_name (telephony_h handle, char **network_name)
	Gets the name of the current registered network.
int	telephony_network_get_type (telephony_h handle, telephony_network_type_e *network_type)
	Gets the network service type of the current registered network.
int	telephony_network_get_ps_type (telephony_h handle, telephony_network_ps_type_e *ps_type)
	Gets the packet service type of the current registered network.
int	telephony_network_get_network_name_option (telephony_h handle, telephony_network_name_option_e *network_name_option)
	Gets the network name option of the current registered network.
int	telephony_network_get_service_state (telephony_h handle, telephony_network_service_state_e *network_service_state)
	Gets the current network state of the telephony service.
int	telephony_network_get_default_data_subscription (telephony_h handle, telephony_network_default_data_subs_e *default_sub)
	Gets the current default subscription for data service (Packet Switched).
int	telephony_network_get_default_subscription (telephony_h handle, telephony_network_default_subs_e *default_sub)
	Gets the current default subscription for voice service (Circuit Switched).
int	telephony_network_get_selection_mode (telephony_h handle, telephony_network_selection_mode_e *mode)
	Gets the network selection mode.
int	telephony_network_get_tac (telephony_h handle, int *tac)
	Gets the TAC (Tracking Area Code) of the current location.
int	telephony_network_get_system_id (telephony_h handle, int *sid)
	Gets the system ID of the current location.
int	telephony_network_get_network_id (telephony_h handle, int *nid)
	Gets the network ID of the current location.
int	telephony_network_get_base_station_id (telephony_h handle, int *bs_id)
	Gets the base station ID of the current location.
int	telephony_network_get_base_station_latitude (telephony_h handle, int *bs_latitude)
	Gets the base station latitude of the current location.
int	telephony_network_get_base_station_longitude (telephony_h handle, int *bs_longitude)
	Gets the base station longitude of the current location.
int	telephony_network_get_signal_strength (telephony_h handle, int *dbm)
	Gets the received signal strength (dBm).

Enumeration Type Documentation

enum telephony_network_default_data_subs_e

Enumeration for the possible 'default' Data Subscriptions for Packet Switched(PS).

Since :: 3.0

Enumerator:

TELEPHONY_NETWORK_DEFAULT_DATA_SUBS_UNKNOWN	Unknown status
TELEPHONY_NETWORK_DEFAULT_DATA_SUBS_SIM1	SIM 1
TELEPHONY_NETWORK_DEFAULT_DATA_SUBS_SIM2	SIM 2

enum telephony_network_default_subs_e

Enumeration for defining possible 'default' Subscriptions for Circuit Switched(CS).

Since :: 3.0

Enumerator:

TELEPHONY_NETWORK_DEFAULT_SUBS_UNKNOWN	Unknown status
TELEPHONY_NETWORK_DEFAULT_SUBS_SIM1	SIM 1 network
TELEPHONY_NETWORK_DEFAULT_SUBS_SIM2	SIM 2 network

enum telephony_network_name_option_e

Enumeration for Network Name Priority.

Since :: 3.0

Enumerator:

TELEPHONY_NETWORK_NAME_OPTION_UNKNOWN	Unknown
TELEPHONY_NETWORK_NAME_OPTION_SPN	Network name displayed by SPN
TELEPHONY_NETWORK_NAME_OPTION_NETWORK	Network name displayed by Network
TELEPHONY_NETWORK_NAME_OPTION_ANY	Network name displayed by SPN or Network

enum telephony_network_ps_type_e

Enumeration for PS Type.

Since :: 3.0

Enumerator:

TELEPHONY_NETWORK_PS_TYPE_UNKNOWN	Unknown
TELEPHONY_NETWORK_PS_TYPE_HSDPA	HSDPA ps type
TELEPHONY_NETWORK_PS_TYPE_HSUPA	HSUPA ps type
TELEPHONY_NETWORK_PS_TYPE_HSPA	HSPA ps type
TELEPHONY_NETWORK_PS_TYPE_HSPAP	HSPAP ps type

enum telephony_network_rssi_e

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

enum telephony_network_selection_mode_e

Enumeration for network selection mode.

Since :: 3.0

Enumerator:

TELEPHONY_NETWORK_SELECTION_MODE_AUTOMATIC	Automatic mode
TELEPHONY_NETWORK_SELECTION_MODE_MANUAL	Manual mode

enum telephony_network_service_state_e

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

enum telephony_network_type_e

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
TELEPHONY_NETWORK_TYPE_IS95A	IS95A network type (Since: 3.0)
TELEPHONY_NETWORK_TYPE_IS95B	IS95B network type (Since: 3.0)
TELEPHONY_NETWORK_TYPE_CDMA_1X	CDMA 1x network type (Since: 3.0)
TELEPHONY_NETWORK_TYPE_EVDO_REV_0	EVDO revision 0 network type (Since: 3.0)
TELEPHONY_NETWORK_TYPE_EVDO_REV_A	EVDO revision A network type (Since: 3.0)
TELEPHONY_NETWORK_TYPE_EVDO_REV_B	EVDO revision B network type (Since: 3.0)
TELEPHONY_NETWORK_TYPE_EVDV	EVDV network type (Since: 3.0)
TELEPHONY_NETWORK_TYPE_EHRPD	EHRPD network type (Since: 3.0)

Function Documentation

int telephony_network_get_base_station_id	(	telephony_h	handle,
		int *	bs_id
	)

Gets the base station ID of the current location.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/location.coarse

Remarks:: This API can be used in CDMA network.

Parameters:

[in]	handle	The handle from telephony_init()
[out]	bs_id	The base station ID, `-1` if unknown

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

See also:: telephony_network_get_service_state(); telephony_network_get_type()

int telephony_network_get_base_station_latitude	(	telephony_h	handle,
		int *	bs_latitude
	)

Gets the base station latitude of the current location.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/location.coarse

Remarks:: This API can be used in CDMA network.

Parameters:

[in]	handle	The handle from telephony_init()
[out]	bs_latitude	The base station latitude, `0x7FFFFFFF` if unknown

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

See also:: telephony_network_get_service_state(); telephony_network_get_type()

int telephony_network_get_base_station_longitude	(	telephony_h	handle,
		int *	bs_longitude
	)

Gets the base station longitude of the current location.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/location.coarse

Remarks:: This API can be used in CDMA network.

Parameters:

[in]	handle	The handle from telephony_init()
[out]	bs_longitude	The base station longitude, `0x7FFFFFFF` if unknown

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

See also:: telephony_network_get_service_state(); telephony_network_get_type()

int telephony_network_get_cell_id	(	telephony_h	handle,
		int *	cell_id
	)

Gets the cell ID of the current location.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/location.coarse

Remarks:: This API can be used in GSM / WCDMA / LTE network.
http://tizen.org/privilege/location.coarse privilege is required to use this API since 3.0.
http://tizen.org/privilege/telephony privilege is no longer required since 3.0.

Parameters:

[in]	handle	The handle from telephony_init()
[out]	cell_id	The cell identification number, `-1` if unknown

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

See also:: telephony_network_get_service_state(); telephony_network_get_type()

int telephony_network_get_default_data_subscription	(	telephony_h	handle,
		telephony_network_default_data_subs_e *	default_sub
	)

Gets the current default subscription for data service (Packet Switched).

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Parameters:

[in]	handle	The handle from telephony_init()
[out]	default_sub	The current default data subscription

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

int telephony_network_get_default_subscription	(	telephony_h	handle,
		telephony_network_default_subs_e *	default_sub
	)

Gets the current default subscription for voice service (Circuit Switched).

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Parameters:

[in]	handle	The handle from telephony_init()
[out]	default_sub	The current default voice subscription

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

int telephony_network_get_lac	(	telephony_h	handle,
		int *	lac
	)

Gets the LAC (Location Area Code) of the current location.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/location.coarse

Remarks:: This API can be used in GSM / WCDMA network.
http://tizen.org/privilege/location.coarse privilege is required to use this API since 3.0.
http://tizen.org/privilege/telephony privilege is no longer required since 3.0.

Parameters:

[in]	handle	The handle from telephony_init()
[out]	lac	The Location Area Code, `-1` if unknown

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

See also:: telephony_network_get_service_state(); telephony_network_get_type()

int telephony_network_get_mcc	(	telephony_h	handle,
		char **	mcc
	)

Gets the MCC (Mobile Country Code) of the current registered network.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Remarks:: This API can be used in GSM / WCDMA / LTE network. You must release mcc using free() on success case, empty string if unknown.

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:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

int telephony_network_get_mnc	(	telephony_h	handle,
		char **	mnc
	)

Gets the MNC (Mobile Network Code) of the current registered network.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Remarks:: This API can be used in GSM / WCDMA / LTE network. You must release mnc using free() on success case, empty string if unknown.

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:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

int telephony_network_get_network_id	(	telephony_h	handle,
		int *	nid
	)

Gets the network ID of the current location.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/location.coarse

Remarks:: This API can be used in CDMA network.

Parameters:

[in]	handle	The handle from telephony_init()
[out]	nid	The network ID, `-1` if unknown

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

See also:: telephony_network_get_service_state(); telephony_network_get_type()

int telephony_network_get_network_name	(	telephony_h	handle,
		char **	network_name
	)

Gets the name of the current registered network.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Remarks:: This API can be used in GSM / WCDMA / LTE network. You must release network_name using free() on success case.

Parameters:

[in]	handle	The handle from telephony_init()
[out]	network_name	The name of the current registered network, empty string if unknown

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

int telephony_network_get_network_name_option	(	telephony_h	handle,
		telephony_network_name_option_e *	network_name_option
	)

Gets the network name option of the current registered network.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Parameters:

[in]	handle	The handle from telephony_init()
[out]	network_name_option	The network name display option

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

int telephony_network_get_ps_type	(	telephony_h	handle,
		telephony_network_ps_type_e *	ps_type
	)

Gets the packet service type of the current registered network.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Remarks:: This API can be used in HSDPA network.

Parameters:

[in]	handle	The handle from telephony_init()
[out]	ps_type	The type of packet service

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

See also:: telephony_network_get_service_state(); telephony_network_get_type()

int telephony_network_get_roaming_status	(	telephony_h	handle,
		bool *	status
	)

Gets the roaming state 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]	status	`true` if roaming, otherwise `false` if not roaming

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

int telephony_network_get_rssi	(	telephony_h	handle,
		telephony_network_rssi_e *	rssi
	)

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:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

int telephony_network_get_selection_mode	(	telephony_h	handle,
		telephony_network_selection_mode_e *	mode
	)

Gets the network selection mode.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Parameters:

[in]	handle	The handle from telephony_init()
[out]	mode	The network selection mode

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

int telephony_network_get_service_state	(	telephony_h	handle,
		telephony_network_service_state_e *	network_service_state
	)

Gets the current network state of the telephony service.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Remarks:: To know the state of data network, refer connection API.

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:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

int telephony_network_get_signal_strength	(	telephony_h	handle,
		int *	dbm
	)

Gets the received signal strength (dBm).

Since :: 4.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Parameters:

[in]	handle	The handle from telephony_init()
[out]	dbm	The received signal strength in dBm, `0` if unknown The higher the received number, the stronger the signal

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

int telephony_network_get_system_id	(	telephony_h	handle,
		int *	sid
	)

Gets the system ID of the current location.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/location.coarse

Remarks:: This API can be used in CDMA network.

Parameters:

[in]	handle	The handle from telephony_init()
[out]	sid	The system ID, `-1` if unknown

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

See also:: telephony_network_get_service_state(); telephony_network_get_type()

int telephony_network_get_tac	(	telephony_h	handle,
		int *	tac
	)

Gets the TAC (Tracking Area Code) of the current location.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/location.coarse

Remarks:: This API can be used in LTE network.

Parameters:

[in]	handle	The handle from telephony_init()
[out]	tac	The Tracking Area Code, `-1` if unknown

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

See also:: telephony_network_get_service_state(); telephony_network_get_type()

int telephony_network_get_type	(	telephony_h	handle,
		telephony_network_type_e *	network_type
	)

Gets the network service type of the current registered network.

Since :: 2.3.1

Privilege Level:: public

Privilege:: http://tizen.org/privilege/telephony

Remarks:: This API can be used in case network is in service.

Parameters:

[in]	handle	The handle from telephony_init()
[out]	network_type	The network service type

Returns:: 0 on success, otherwise a negative error value

Return values:

TELEPHONY_ERROR_NONE	Successful
TELEPHONY_ERROR_INVALID_PARAMETER	Invalid parameter
TELEPHONY_ERROR_PERMISSION_DENIED	Permission denied
TELEPHONY_ERROR_NOT_SUPPORTED	Not supported
TELEPHONY_ERROR_OPERATION_FAILED	Operation failed

See also:: telephony_network_get_service_state()

Required Header

Overview

Related Features

Functions

Enumeration Type Documentation

Function Documentation