Tizen Native API
7.0
|
The contacts SIM API provides the set of definitions and interfaces that enable application developers to get/set data from/to SIM card.
Required Header
#include <contacts.h>
Related Features
This API is related with the following features:
- 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 | contacts_sim_import_all_contacts (void) TIZEN_DEPRECATED_API |
Imports all contacts from first SIM to Contacts Database. | |
int | contacts_sim_get_initialization_status (bool *completed) TIZEN_DEPRECATED_API |
Checks whether first SIM initialization is completed. | |
int | contacts_sim_import_all_contacts_by_sim_slot_no (int sim_slot_no, contacts_sim_import_progress_cb callback, void *user_data) |
Imports all contacts from SIM of the given SIM slot number to the Contacts Database. | |
int | contacts_sim_get_initialization_status_by_sim_slot_no (int sim_slot_no, bool *completed) |
Checks whether SIM of the given SIM slot number is initialized. | |
Typedefs | |
typedef bool(* | contacts_sim_import_progress_cb )(int total, int imported_cnt, void *user_data) |
Called whenever a contact is imported. |
Typedef Documentation
typedef bool(* contacts_sim_import_progress_cb)(int total, int imported_cnt, void *user_data) |
Called whenever a contact is imported.
- Since :
- 3.0
- Parameters:
-
[in] total The number of contacts that will be imported [in] imported_cnt The number of already imported contacts [in] user_data The user data passed from the callback registration function
- Returns:
true
to continue with the import of contacts otherwisefalse
to stop the import of contacts
- Precondition:
- contacts_sim_import_all_contacts_by_sim_slot_no() will invoke this callback.
Function Documentation
int contacts_sim_get_initialization_status | ( | bool * | completed | ) |
Checks whether first SIM initialization is completed.
- Deprecated:
- Deprecated since 3.0. Use contacts_sim_get_initialization_status_by_sim_slot_no() instead.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/contact.read
- Parameters:
-
[out] completed true
if SIM is initialized, otherwisefalse
if SIM is not initialized
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
CONTACTS_ERROR_NONE Successful CONTACTS_ERROR_INVALID_PARAMETER Invalid parameter CONTACTS_ERROR_PERMISSION_DENIED Permission denied. This application does not have the privilege to call this method. CONTACTS_ERROR_NOT_SUPPORTED Not supported CONTACTS_ERROR_IPC Unknown IPC error CONTACTS_ERROR_SYSTEM Internal system module error
- Precondition:
- contacts_connect() should be called to open a connection to the contacts service.
- See also:
- contacts_connect()
int contacts_sim_get_initialization_status_by_sim_slot_no | ( | int | sim_slot_no, |
bool * | completed | ||
) |
Checks whether SIM of the given SIM slot number is initialized.
- Since :
- 3.0
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/contact.read
- Parameters:
-
[in] sim_slot_no The SIM slot number; 0 means first SIM, 1 means second SIM [out] completed true
if SIM is initialized, otherwisefalse
if SIM is not initialized
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
CONTACTS_ERROR_NONE Successful CONTACTS_ERROR_INVALID_PARAMETER Invalid parameter CONTACTS_ERROR_PERMISSION_DENIED Permission denied. This application does not have the privilege to call this method CONTACTS_ERROR_NOT_SUPPORTED Not supported CONTACTS_ERROR_IPC Unknown IPC error CONTACTS_ERROR_SYSTEM Internal system module error
- Precondition:
- contacts_connect() should be called to open a connection to the contacts service.
- See also:
- contacts_connect()
int contacts_sim_import_all_contacts | ( | void | ) |
Imports all contacts from first SIM to Contacts Database.
- Deprecated:
- Deprecated since 3.0. Use contacts_sim_import_all_contacts_by_sim_slot_no() instead.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/contact.write
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
CONTACTS_ERROR_NONE Successful CONTACTS_ERROR_INVALID_PARAMETER Invalid parameter CONTACTS_ERROR_NO_DATA Requested data does not exist CONTACTS_ERROR_PERMISSION_DENIED Permission denied. This application does not have the privilege to call this method. CONTACTS_ERROR_NOT_SUPPORTED Not supported CONTACTS_ERROR_IPC Unknown IPC error CONTACTS_ERROR_SYSTEM Internal system module error CONTACTS_ERROR_INTERNAL Implementation Error, Temporary Use
- Precondition:
- contacts_connect() should be called to open a connection to the contacts service.
- See also:
- contacts_connect()
int contacts_sim_import_all_contacts_by_sim_slot_no | ( | int | sim_slot_no, |
contacts_sim_import_progress_cb | callback, | ||
void * | user_data | ||
) |
Imports all contacts from SIM of the given SIM slot number to the Contacts Database.
This function invokes contacts_sim_import_progress_cb() to indicate the progress of imports whenever a contact is imported.
- Since :
- 3.0
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/contact.write
- Parameters:
-
[in] sim_slot_no The SIM slot number; 0 means first SIM, 1 means second SIM [in] callback The callback function to invoke [in] user_data The user data to be passed to the callback function
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
CONTACTS_ERROR_NONE Successful CONTACTS_ERROR_INVALID_PARAMETER Invalid parameter CONTACTS_ERROR_NO_DATA Requested data does not exist CONTACTS_ERROR_PERMISSION_DENIED Permission denied. This application does not have the privilege to call this method CONTACTS_ERROR_NOT_SUPPORTED Not supported CONTACTS_ERROR_IPC Unknown IPC error CONTACTS_ERROR_SYSTEM Internal system module error
- Precondition:
- contacts_connect() should be called to open a connection to the contacts service.