Tizen Native API

Functions

int contacts_sim_import_all_contacts (void)
 Imports all contacts from SIM to Contacts Database.
int contacts_sim_get_initialization_status (bool *completed)
 Checks whether SIM initialization is completed.

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:

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.


Function Documentation

int contacts_sim_get_initialization_status ( bool *  completed)

Checks whether SIM initialization is completed.

Since :
2.3
Privilege Level:
public
Privilege:
http://tizen.org/privilege/contact.read
Parameters:
[out]completedtrue if SIM is initialized, otherwise false if SIM is not initialized
Returns:
0 on success, otherwise a negative error value
Return values:
CONTACTS_ERROR_NONESuccessful
CONTACTS_ERROR_INVALID_PARAMETERInvalid parameter
CONTACTS_ERROR_PERMISSION_DENIEDPermission denied. This application does not have the privilege to call this method.
CONTACTS_ERROR_NOT_SUPPORTEDNot supported
CONTACTS_ERROR_IPCUnknown IPC error
CONTACTS_ERROR_SYSTEMInternal system module error
Precondition:
contacts_connect() should be called to open a connection to the contacts service.
See also:
contacts_connect()

Imports all contacts from SIM to Contacts Database.

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_NONESuccessful
CONTACTS_ERROR_INVALID_PARAMETERInvalid parameter
CONTACTS_ERROR_NO_DATARequested data does not exist
CONTACTS_ERROR_PERMISSION_DENIEDPermission denied. This application does not have the privilege to call this method.
CONTACTS_ERROR_NOT_SUPPORTEDNot supported
CONTACTS_ERROR_IPCUnknown IPC error
CONTACTS_ERROR_SYSTEMInternal system module error
CONTACTS_ERROR_INTERNALImplementation Error, Temporary Use
Precondition:
contacts_connect() should be called to open a connection to the contacts service.
See also:
contacts_connect()