Tizen Native API
|
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 access, but not change the information about IMEI.
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.
Functions | |
int | telephony_modem_get_imei (telephony_h handle, char **imei) |
Gets the IMEI (International Mobile Station Equipment Identity) of a mobile phone. |
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.1
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/telephony
- Remarks:
- You must release
imei
using free().
- 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