Functions
int	telephony_network_get_lac (telephony_h handle, int *lac)
	Gets the LAC (Location Area Code) of the current network.
int	telephony_network_get_cell_id (telephony_h handle, int *cell_id)
	Gets the cell ID.
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.
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).

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:

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

Enumeration Type Documentation

enum telephony_network_default_data_subs_e

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

Since :: 2.4

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 defines possible 'default' Subscriptions for Circuit Switched(CS).

Since :: 2.4

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 :: 2.4

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 :: 2.4

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

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_service_state_e

Enumeration for Network Service State.

Since :: 2.3

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

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

int telephony_network_get_cell_id	(	telephony_h	handle,
		int *	cell_id
	)

Gets the cell ID.

Since :: 2.3

Privilege Level:: public

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

Parameters:

[in]	handle	The handle from telephony_init()
[out]	cell_id	The cell identification number

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

Precondition:: The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.

See also:: telephony_network_get_service_state()

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 :: 2.4

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 :: 2.4

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

Since :: 2.3

Privilege Level:: public

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

Parameters:

[in]	handle	The handle from telephony_init()
[out]	lac	The Location Area Code

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

Precondition:: The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.

See also:: telephony_network_get_service_state()

int telephony_network_get_mcc	(	telephony_h	handle,
		char **	mcc
	)

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

Since :: 2.3

Privilege Level:: public

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

Remarks:: You must release mcc using free().

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

Precondition:: The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.

See also:: telephony_network_get_service_state()

int telephony_network_get_mnc	(	telephony_h	handle,
		char **	mnc
	)

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

Since :: 2.3

Privilege Level:: public

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

Remarks:: You must release mnc using free().

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

Precondition:: The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.

See also:: telephony_network_get_service_state()

int telephony_network_get_network_name	(	telephony_h	handle,
		char **	network_name
	)

Gets the name of the current registered network.

Since :: 2.3

Privilege Level:: public

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

Remarks:: You must release network_name using free().

Parameters:

[in]	handle	The handle from telephony_init()
[out]	network_name	The name of the current registered network

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

Precondition:: The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.

See also:: telephony_network_get_service_state()

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 :: 2.4

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

Precondition:: The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.

See also:: telephony_network_get_service_state()

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 :: 2.4

Privilege Level:: public

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

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

Precondition:: The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.

See also:: telephony_network_get_service_state()

int telephony_network_get_roaming_status	(	telephony_h	handle,
		bool *	status
	)

Gets the roaming state.

Since :: 2.3

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

Precondition:: The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.

See also:: telephony_network_get_service_state()

int telephony_network_get_rssi	(	telephony_h	handle,
		telephony_network_rssi_e *	rssi
	)

Gets the RSSI (Received Signal Strength Indicator).

Since :: 2.3

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

Precondition:: The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.

See also:: telephony_network_get_service_state()

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

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_type	(	telephony_h	handle,
		telephony_network_type_e *	network_type
	)

Gets the network service type of the current registered network.

Since :: 2.3

Privilege Level:: public

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

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

Precondition:: The Network service state must be TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE.

See also:: telephony_network_get_service_state()

Functions

Required Header

Overview

Related Features

Enumeration Type Documentation

Function Documentation