The SIM API provides functions to obtain information from the SIM card, as well as SIM status.
Required Header
#include <telephony.h>
Overview
The Telephony SIM API allows you to extract information stored on a SIM card, but not change the information.
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 the state of SIM card.
- Since :
- 2.3
- Enumerator:
TELEPHONY_SIM_STATE_UNAVAILABLE |
SIM is not available on this device
|
TELEPHONY_SIM_STATE_LOCKED |
SIM is locked
|
TELEPHONY_SIM_STATE_AVAILABLE |
SIM is available on this device
|
TELEPHONY_SIM_STATE_UNKNOWN |
SIM is in transition between states
|
Function Documentation
Gets the Integrated Circuit Card IDentification (ICC-ID).
The Integrated Circuit Card Identification number internationally identifies SIM cards.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/telephony
- Parameters:
-
[in] | handle | The handle from telephony_init() |
[out] | icc_id | The Integrated Circuit Card Identification |
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
- Precondition:
- The SIM state must be TELEPHONY_SIM_STATE_AVAILABLE.
- See also:
- telephony_sim_get_state()
Gets the Mobile Subscription Identification Number (MSIN [9~10 digits]) of the SIM provider.
This function gets Mobile Subscription Identification Number embedded in the SIM card.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/telephony
- Parameters:
-
[in] | handle | The handle from telephony_init() |
[out] | msin | The Mobile Subscription Identification Number |
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
- Precondition:
- The SIM state must be TELEPHONY_SIM_STATE_AVAILABLE.
- See also:
- telephony_sim_get_state()
Gets the SIM Operator (MCC [3 digits] + MNC [2~3 digits]).
The Operator is embedded in the SIM card.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/telephony
- Parameters:
-
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
- Precondition:
- The SIM state must be TELEPHONY_SIM_STATE_AVAILABLE.
- See also:
- telephony_sim_get_state()
Gets the Service Provider Name (SPN) of the SIM card.
This function gets Service Provider Name embedded in the SIM card. If this value is not stored in SIM card, NULL
will be returned.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/telephony
- Parameters:
-
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
- Precondition:
- The SIM state must be TELEPHONY_SIM_STATE_AVAILABLE.
- See also:
- telephony_sim_get_state()
Gets the state of the SIM.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/telephony
- Parameters:
-
[in] | handle | The handle from telephony_init() |
[out] | sim_state | The current state of the SIM |
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
Gets the SIM card subscriber number.
This function gets subscriber number embedded in the SIM card. This value contains MSISDN related to the subscriber. If this value is not stored in SIM card, NULL
will be returned.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/telephony
- Parameters:
-
[in] | handle | The handle from telephony_init() |
[out] | subscriber_number | The subscriber number in the SIM |
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
- Precondition:
- The SIM state must be TELEPHONY_SIM_STATE_AVAILABLE.
- See also:
- telephony_sim_get_state()
Checks whether the current SIM card is different from the previous SIM card.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/telephony
- Parameters:
-
[in] | handle | The handle from telephony_init() |
[out] | is_changed | true if the current SIM card is different from the previous SIM card, otherwise false if the SIM card is not changed |
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
- Precondition:
- The SIM state must be TELEPHONY_SIM_STATE_AVAILABLE.
- See also:
- telephony_sim_get_state()