Tizen Native API
4.0
|
The Modem Information API provides functions to obtain information from the modem.
Required Header
#include <telephony.h>
Overview
The Telephony Modem Information API allows you to get modem information such as IMEI, but not to 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 Element.
Functions | |
int | telephony_modem_get_imei (telephony_h handle, char **imei) |
Gets the IMEI (International Mobile Station Equipment Identity) of a mobile phone. | |
int | telephony_modem_get_power_status (telephony_h handle, telephony_modem_power_status_e *status) |
Gets the power status of the modem. | |
int | telephony_modem_get_meid (telephony_h handle, char **meid) |
Gets the MEID (Mobile Equipment Identifier) of a mobile phone (for CDMA). |
Enumeration Type Documentation
Enumeration for Modem Power Status.
- Since :
- 2.4
Function Documentation
int telephony_modem_get_imei | ( | telephony_h | handle, |
char ** | imei | ||
) |
Gets the IMEI (International Mobile Station Equipment Identity) of a mobile phone.
The IMEI number is used by a GSM network to identify valid devices and therefore can be used for stopping a stolen phone from accessing that network.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/telephony
- Remarks:
- You must release
imei
using free() on success case. -
Since 5.5, privilege level and return type are changed.
The following table shows the impact of changes:Version 5.0 and lower 5.5 and higher Remarks Privilege http://tizen.org/privilege/telephony http://tizen.org/privilege/securesysteminfo The required privilege is changed. Privilege level Public Partner The application having partner level privilege can use this API Error TELEPHONY_ERROR_NONE TELEPHONY_ERROR_PERMISSION_DENIED If the application doesn't have the required privilege, the error is returned. - The applications developed on Tizen 5.0 and lower version having only http://tizen.org/privilege/telephony privilege should check 'permission denied' error.
- Parameters:
-
[in] handle The handle from telephony_init() [out] imei The International Mobile Station Equipment Identity
- 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_modem_get_meid | ( | telephony_h | handle, |
char ** | meid | ||
) |
Gets the MEID (Mobile Equipment Identifier) of a mobile phone (for CDMA).
- Since :
- 3.0
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/telephony
- Remarks:
- You must release
meid
using free() on success case. -
Since 5.5, privilege level and return type are changed.
The following table shows the impact of changes:Version 5.0 and lower 5.5 and higher Remarks Privilege http://tizen.org/privilege/telephony http://tizen.org/privilege/securesysteminfo The required privilege is changed. Privilege level Public Partner The application having partner level privilege can use this API Error TELEPHONY_ERROR_NONE TELEPHONY_ERROR_PERMISSION_DENIED If the application doesn't have the required privilege, the error is returned. - The applications developed on Tizen 5.0 and lower version having only http://tizen.org/privilege/telephony privilege should check 'permission denied' error.
- Parameters:
-
[in] handle The handle from telephony_init() [out] meid The Mobile Equipment Identifier
- 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_modem_get_power_status | ( | telephony_h | handle, |
telephony_modem_power_status_e * | status | ||
) |
Gets the power status of the modem.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/telephony
- Parameters:
-
[in] handle The handle from telephony_init() [out] status The Modem power status (0=on,1=off,2=reset,3=low)
- 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