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_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 bool(* contacts_sim_import_progress_cb)(int total, int imported_cnt, void *user_data)

Called whenever a contact is imported.

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 otherwise false to stop the import of contacts

Precondition:: contacts_sim_import_all_contacts_by_sim_slot_no() will invoke this callback.

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.

Parameters:

[in]	sim_slot_no	The SIM slot number; 0 means first SIM, 1 means second SIM
[out]	completed	`true` if SIM is initialized, otherwise `false` if SIM is not initialized

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.

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.

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

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.