Called when the designated view changes.

Since :

2.3

Parameters:

[in]	view_uri	The view URI
[in]	user_data	The user data passed from the callback registration function

Precondition:

The callback must be registered using contacts_db_add_changed_cb.

See also:

contacts_db_add_changed_cb()

Called when contacts-service server status changes.

Since :

2.3

Parameters:

[in]	status	The current status of server
[in]	user_data	The user data passed from the callback registration function

Precondition:

This function requires an open connection to contacts service by contacts_connect().

See also:

contacts_db_add_status_changed_cb()

Enumeration for contact change state.

Since :

2.3

Enumerator:

CONTACTS_CHANGE_INSERTED	Inserted
CONTACTS_CHANGE_UPDATED	Updated
CONTACTS_CHANGE_DELETED	Deleted

Enumeration for contact DB status.

Since :

2.3

Enumerator:

CONTACTS_DB_STATUS_NORMAL	Normal
CONTACTS_DB_STATUS_CHANGING_COLLATION	DB status is Changing collation

Registers a callback function to be invoked when a record changes.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.read

Privilege:

http://tizen.org/privilege/callhistory.read

Remarks:

http://tizen.org/privilege/contact.read is needed for record which is related to _contacts_address_book view, _contacts_person view,
_contacts_contact view, _contacts_simple_contact view, _contacts_group view, _contacts_my_profile view,
_contacts_name view, _contacts_number view, _contacts_email view, _contacts_address view,
_contacts_note view, _contacts_url view, _contacts_event view, _contacts_image view,
_contacts_company view, _contacts_nickname view, _contacts_messenger view, _contacts_extension view,
_contacts_profile view, _contacts_relationship view, _contacts_activity view, _contacts_activity_photo view,
_contacts_speeddial view, _contacts_sdn view, _contacts_group_relation view.

http://tizen.org/privilege/callhistory.read is needed for record which is related to _contacts_phone_log view. If successive change notification produced on the view_uri are identical, then they are coalesced into a single notification if the older notification has not yet been called because default main loop is doing something. But, it means that a callback function is not called to reliably count of change.

Parameters:

[in]	view_uri	The view URI of records whose changes are monitored
[in]	callback	The callback function to register
[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_OUT_OF_MEMORY	Out of memory
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_SYSTEM	System error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

Postcondition:

contacts_db_changed_cb() will be invoked when the designated view changes.

See also:

contacts_connect()

contacts_db_changed_cb()

contacts_db_remove_changed_cb()

Registers a callback function.

Since :

2.3

Parameters:

[in]	callback	The callback function to register
[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

Precondition:

This function requires an open connection to the contacts service by contacts_connect().

See also:

contacts_connect()

contacts_db_remove_status_changed_cb()

Deletes a record from the contacts database with related child records.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.write

Privilege:

http://tizen.org/privilege/callhistory.write

Remarks:

http://tizen.org/privilege/contact.write is needed for record which is related to _contacts_address_book view, _contacts_contact view,
_contacts_group view, _contacts_my_profile view, _contacts_name view, _contacts_number view,
_contacts_email view, _contacts_address view, _contacts_note view, _contacts_url view,
_contacts_event view, _contacts_image view, _contacts_company view, _contacts_nickname view,
_contacts_messenger view, _contacts_extension view, _contacts_profile view, _contacts_relationship view,
_contacts_activity view, _contacts_activity_photo view, _contacts_speeddial view.

http://tizen.org/privilege/callhistory.write is needed for record which is related to _contacts_phone_log view.

Parameters:

[in]	view_uri	The view URI of a record
[in]	record_id	The record ID to delete

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_OUT_OF_MEMORY	Out of memory
CONTACTS_ERROR_INVALID_PARAMETER	Invalid parameter
CONTACTS_ERROR_FILE_NO_SPACE	FS Full
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_DB	Database operation failure
CONTACTS_ERROR_IPC	IPC error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

Postcondition:

contacts_db_changed_cb() callback wil be called upon success.

See also:

contacts_connect()

contacts_db_insert_record()

Deletes multiple records in the contacts database with related child records.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.write

Privilege:

http://tizen.org/privilege/callhistory.write

Remarks:

http://tizen.org/privilege/contact.write is needed for record which is related to _contacts_address_book view, _contacts_contact view,
_contacts_group view, _contacts_my_profile view, _contacts_name view, _contacts_number view,
_contacts_email view, _contacts_address view, _contacts_note view, _contacts_url view,
_contacts_event view, _contacts_image view, _contacts_company view, _contacts_nickname view,
_contacts_messenger view, _contacts_extension view, _contacts_profile view, _contacts_relationship view,
_contacts_activity view, _contacts_activity_photo view, _contacts_speeddial view.

http://tizen.org/privilege/callhistory.write is needed for record which is related to _contacts_phone_log view.

Parameters:

[in]	view_uri	The view URI of records
[in]	record_id_array	The record IDs to delete
[in]	count	The size of record ID array

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_OUT_OF_MEMORY	Out of memory
CONTACTS_ERROR_INVALID_PARAMETER	Invalid parameter
CONTACTS_ERROR_FILE_NO_SPACE	FS Full
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_DB	Database operation failure
CONTACTS_ERROR_IPC	IPC error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

Postcondition:

contacts_db_changed_cb() callback wil be called upon success.

See also:

contacts_connect()

contacts_db_insert_records()

contacts_db_update_records()

Retrieves all records and returns the results list.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.read

Privilege:

http://tizen.org/privilege/callhistory.read

Remarks:

You must release record_list using contacts_list_destroy().
http://tizen.org/privilege/contact.read is needed for record which is related to _contacts_address_book view, _contacts_person view,
_contacts_contact view, _contacts_simple_contact view, _contacts_group view, _contacts_my_profile view,
_contacts_name view, _contacts_number view, _contacts_email view, _contacts_address view,
_contacts_note view, _contacts_url view, _contacts_event view, _contacts_image view,
_contacts_company view, _contacts_nickname view, _contacts_messenger view, _contacts_extension view,
_contacts_profile view, _contacts_relationship view, _contacts_activity view, _contacts_activity_photo view,
_contacts_speeddial view, _contacts_sdn view and all read-only views except views which are related to phone log.

http://tizen.org/privilege/callhistory.read is needed for record which is related to _contacts_phone_log view, _contacts_phone_log_stat view (read only).
_contacts_person_phone_log view (read only) view is needed both privileges.

Parameters:

[in]	view_uri	The view URI to get records
[in]	offset	The index from which to get results
[in]	limit	The number to limit results(value 0 is used for all records)
[out]	record_list	The record list

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_OUT_OF_MEMORY	Out of memory
CONTACTS_ERROR_INVALID_PARAMETER	Invalid parameter
CONTACTS_ERROR_FILE_NO_SPACE	FS Full
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_DB	Database operation failure
CONTACTS_ERROR_IPC	IPC error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

See also:

contacts_connect()

contacts_list_destroy()

Retrieves records changes since the given database version.

This function will find all changed records since the given contacts_db_version.
Now, support _contacts_contact_updated_info view (read only), _contacts_group_updated_info view (read only)
_contacts_my_profile_updated_info view (read only) and _contacts_grouprel_updated_info view (read only).

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.read

Remarks:

You must release record_list using contacts_list_destroy().

Parameters:

[in]	view_uri	The view URI to get records
[in]	address_book_id	The address book ID to filter
[in]	contacts_db_version	The contacts database version
[out]	change_record_list	The record list
[out]	current_contacts_db_version	The current contacts database version

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_OUT_OF_MEMORY	Out of memory
CONTACTS_ERROR_INVALID_PARAMETER	Invalid parameter
CONTACTS_ERROR_FILE_NO_SPACE	FS Full
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_DB	Database operation failure
CONTACTS_ERROR_IPC	IPC error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

See also:

contacts_connect()

contacts_list_destroy()

Gets the number of records in a specific view.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.read

Privilege:

http://tizen.org/privilege/callhistory.read

Remarks:

http://tizen.org/privilege/contact.read is needed for record which is related to _contacts_address_book view, _contacts_person view,
_contacts_contact view, _contacts_simple_contact view, _contacts_group view, _contacts_my_profile view,
_contacts_name view, _contacts_number view, _contacts_email view, _contacts_address view,
_contacts_note view, _contacts_url view, _contacts_event view, _contacts_image view,
_contacts_company view, _contacts_nickname view, _contacts_messenger view, _contacts_extension view,
_contacts_profile view, _contacts_relationship view, _contacts_activity view, _contacts_activity_photo view,
_contacts_speeddial view, _contacts_sdn view and all read-only views except views which is related to phone log.

http://tizen.org/privilege/callhistory.read is needed for record which is related to _contacts_phone_log view, _contacts_phone_log_stat view (read only).
_contacts_person_phone_log view (read only) view is needed both privilege.

Parameters:

[in]	view_uri	The view URI
[out]	count	The count of records

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_OUT_OF_MEMORY	Out of memory
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_DB	Database operation failure
CONTACTS_ERROR_IPC	IPC error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

See also:

contacts_connect()

Gets the number of records matching a query.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.read

Privilege:

http://tizen.org/privilege/callhistory.read

Remarks:

http://tizen.org/privilege/contact.read is needed for record which is related to _contacts_address_book view, _contacts_person view,
_contacts_contact view, _contacts_simple_contact view, _contacts_group view, _contacts_my_profile view,
_contacts_name view, _contacts_number view, _contacts_email view, _contacts_address view,
_contacts_note view, _contacts_url view, _contacts_event view, _contacts_image view,
_contacts_company view, _contacts_nickname view, _contacts_messenger view, _contacts_extension view,
_contacts_profile view, _contacts_relationship view, _contacts_activity view, _contacts_activity_photo view,
_contacts_speeddial view, _contacts_sdn view and all read-only views except views which is related to phone log.

http://tizen.org/privilege/callhistory.read is needed for record which is related to _contacts_phone_log view, _contacts_phone_log_stat view (read only).
_contacts_person_phone_log view (read only) view is needed both privilege.

Parameters:

[in]	query	The query handle
[out]	count	The count of records

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_OUT_OF_MEMORY	Out of memory
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_DB	Database operation failure
CONTACTS_ERROR_IPC	IPC error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

See also:

contacts_connect()

Gets the current contacts database version.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.read

Privilege:

http://tizen.org/privilege/callhistory.read

Parameters:

[out]

contacts_db_version

The contacts database version

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_OUT_OF_MEMORY	Out of memory
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_NO_DATA	Requested data does not exist
CONTACTS_ERROR_DB	Database operation failure
CONTACTS_ERROR_IPC	IPC error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

See also:

contacts_connect()

contacts_db_get_changes_by_version()

Gets the last successful changed contacts database version on the current connection.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.read

Privilege:

http://tizen.org/privilege/callhistory.read

Parameters:

[out]

last_change_version

The database version

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_INVALID_PARAMETER	Invalid parameter
CONTACTS_ERROR_DB	Database operation failure
CONTACTS_ERROR_PERMISSION_DENIED	Permission denied. This application does not have the privilege to call this method.

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

See also:

contacts_connect()

contacts_db_get_current_version()

Gets a record from the contacts database.

This function creates a new contact handle from the contacts database by the given record_id.
record will be created, which is filled with contact information.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.read

Privilege:

http://tizen.org/privilege/callhistory.read

Remarks:

http://tizen.org/privilege/contact.read is needed for record which is related to _contacts_address_book view, _contacts_person view,
_contacts_contact view, _contacts_simple_contact view, _contacts_group view, _contacts_my_profile view,
_contacts_name view, _contacts_number view, _contacts_email view, _contacts_address view,
_contacts_note view, _contacts_url view, _contacts_event view, _contacts_image view,
_contacts_company view, _contacts_nickname view, _contacts_messenger view, _contacts_extension view,
_contacts_profile view, _contacts_relationship view, _contacts_activity view, _contacts_activity_photo view,
_contacts_speeddial view, _contacts_sdn view.

http://tizen.org/privilege/callhistory.read is needed for record which is related to _contacts_phone_log view.

You must release record using contacts_record_destroy().

Parameters:

[in]	view_uri	The view URI of a record
[in]	record_id	The record ID to get from database
[out]	record	The record handle associated with the record ID

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_OUT_OF_MEMORY	Out of memory
CONTACTS_ERROR_INVALID_PARAMETER	Invalid parameter
CONTACTS_ERROR_FILE_NO_SPACE	FS Full
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_DB	Database operation failure
CONTACTS_ERROR_IPC	IPC error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

See also:

contacts_connect()

contacts_record_destroy()

Uses a query to find records.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.read

Privilege:

http://tizen.org/privilege/callhistory.read

Remarks:

You must release record_list using contacts_list_destroy().
http://tizen.org/privilege/contact.read is needed for record which is related to _contacts_address_book view, _contacts_person view,
_contacts_contact view, _contacts_simple_contact view, _contacts_group view, _contacts_my_profile view,
_contacts_name view, _contacts_number view, _contacts_email view, _contacts_address view,
_contacts_note view, _contacts_url view, _contacts_event view, _contacts_image view,
_contacts_company view, _contacts_nickname view, _contacts_messenger view, _contacts_extension view,
_contacts_profile view, _contacts_relationship view, _contacts_activity view, _contacts_activity_photo view,
_contacts_speeddial view, _contacts_sdn view and all read-only views except views which are related to phone log.

http://tizen.org/privilege/callhistory.read is needed for record which is related to _contacts_phone_log view, _contacts_phone_log_stat view (read only).
_contacts_person_phone_log view (read only) view is needed both privileges.

Parameters:

[in]	query	The query to filter the results
[in]	offset	The index from which to get results
[in]	limit	The number to limit results(value 0 is used for get all records)
[out]	record_list	The record list

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_OUT_OF_MEMORY	Out of memory
CONTACTS_ERROR_INVALID_PARAMETER	Invalid parameter
CONTACTS_ERROR_FILE_NO_SPACE	FS Full
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_DB	Database operation failure
CONTACTS_ERROR_IPC	IPC error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

See also:

contacts_connect()

contacts_list_destroy()

Gets the current status of server.

Since :

2.3

Parameters:

[in]

status

The current status of server

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_INVALID_PARAMETER	Invalid parameter

Precondition:

This function requires an open connection to the contacts service by contacts_connect().

See also:

contacts_connect()

Inserts a record to the contacts database.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.write

Privilege:

http://tizen.org/privilege/callhistory.write

Remarks:

http://tizen.org/privilege/contact.write is needed for record which is created with _contacts_address_book view, _contacts_contact view,
_contacts_group view, _contacts_my_profile view, _contacts_name view, _contacts_number view,
_contacts_email view, _contacts_address view, _contacts_note view, _contacts_url view,
_contacts_event view, _contacts_image view, _contacts_company view, _contacts_nickname view,
_contacts_messenger view, _contacts_extension view, _contacts_profile view, _contacts_relationship view,
_contacts_activity view, _contacts_activity_photo view, _contacts_speeddial view.

http://tizen.org/privilege/callhistory.write is needed for record which is created with _contacts_phone_log view.

Parameters:

[in]	record	The record handle
[out]	id	The ID of inserted record

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_OUT_OF_MEMORY	Out of memory
CONTACTS_ERROR_INVALID_PARAMETER	Invalid parameter
CONTACTS_ERROR_FILE_NO_SPACE	FS Full
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_DB	Database operation failure
CONTACTS_ERROR_IPC	IPC error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

Postcondition:

contacts_db_changed_cb() callback wil be called upon success.

See also:

contacts_connect()

contacts_db_update_record()

contacts_db_delete_record()

contacts_db_get_record()

Inserts multiple records to the contacts database.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.write

Privilege:

http://tizen.org/privilege/callhistory.write

Remarks:

http://tizen.org/privilege/contact.write is needed for record which is related to _contacts_address_book view, _contacts_contact view,
_contacts_group view, _contacts_my_profile view, _contacts_name view, _contacts_number view,
_contacts_email view, _contacts_address view, _contacts_note view, _contacts_url view,
_contacts_event view, _contacts_image view, _contacts_company view, _contacts_nickname view,
_contacts_messenger view, _contacts_extension view, _contacts_profile view, _contacts_relationship view,
_contacts_activity view, _contacts_activity_photo view, _contacts_speeddial view.

http://tizen.org/privilege/callhistory.write is needed for record which is related to _contacts_phone_log view.

Parameters:

[in]	record_list	The record list handle
[out]	ids	The IDs of inserted records
[out]	count	The number of IDs

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_OUT_OF_MEMORY	Out of memory
CONTACTS_ERROR_INVALID_PARAMETER	Invalid parameter
CONTACTS_ERROR_FILE_NO_SPACE	FS Full
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_DB	Database operation failure
CONTACTS_ERROR_IPC	IPC error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

Postcondition:

contacts_db_changed_cb() callback wil be called upon success.

See also:

contacts_connect()

contacts_db_update_records()

contacts_db_delete_records()

Unregisters a callback function.

Since :

2.3

Parameters:

[in]	view_uri	The view URI of records whose changes are monitored
[in]	callback	The callback function to register
[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_PERMISSION_DENIED	Permission denied. This application does not have the privilege to call this method.
CONTACTS_ERROR_NO_DATA	Requested data does not exist
CONTACTS_ERROR_NOT_SUPPORTED	Not supported
CONTACTS_ERROR_SYSTEM	System error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

See also:

contacts_connect()

contacts_db_changed_cb()

contacts_db_add_changed_cb()

Unregisters a callback function.

Since :

2.3

Parameters:

[in]	callback	The callback function to register
[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

Precondition:

This function requires an open connection to the contacts service by contacts_connect().

See also:

contacts_connect()

contacts_db_add_status_changed_cb()

Replaces an id-identified record with the given record.

Now, this API supports only _contacts_contact view_uri.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.write

Remarks:

The write-once value of record is not replaced.
This API works only for _contacts_contact view

Parameters:

[in]	record	The new record handle to replace
[in]	id	The DB record ID to be replaced

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_OUT_OF_MEMORY	Out of memory
CONTACTS_ERROR_INVALID_PARAMETER	Invalid parameter
CONTACTS_ERROR_FILE_NO_SPACE	FS Full
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_DB	Database operation failure
CONTACTS_ERROR_IPC	IPC error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

Postcondition:

contacts_db_changed_cb() callback wil be called upon success.

See also:

contacts_connect()

contacts_db_update_record()

contacts_db_delete_record()

contacts_db_get_record()

Replaces database records identified by given ids with a given record list.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.write

Remarks:

The write-once value of record is not replaced.
This API works only for _contacts_contact view

Parameters:

[in]	list	The new record list handle to replace
[in]	record_id_array	The record IDs to replace
[in]	count	The size of record ID array

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_OUT_OF_MEMORY	Out of memory
CONTACTS_ERROR_INVALID_PARAMETER	Invalid parameter
CONTACTS_ERROR_FILE_NO_SPACE	FS Full
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_DB	Database operation failure
CONTACTS_ERROR_IPC	IPC error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

Postcondition:

contacts_db_changed_cb() callback wil be called upon success.

See also:

contacts_connect()

contacts_db_update_record()

contacts_db_delete_record()

contacts_db_get_record()

Finds records based on a given keyword.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.read

Remarks:

You must release record_list using contacts_list_destroy().
This API works only for _contacts_person view, _contacts_person_contact view (read only),
_contacts_person_grouprel view (read only), _contacts_person_group_assigned view (read only)
and _contacts_person_group_not_assigned view (read only).

Parameters:

[in]	view_uri	The view URI to get records
[in]	keyword	The keyword
[in]	offset	The index from which to get results
[in]	limit	The number to limit results(value 0 is used for get all records)
[out]	record_list	The record list

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_OUT_OF_MEMORY	Out of memory
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_DB	Database operation failure
CONTACTS_ERROR_IPC	IPC error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

See also:

contacts_connect()

contacts_list_destroy()

Finds records based on given query and keyword.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.read

Remarks:

You must release record_list using contacts_list_destroy().
This API works only for _contacts_person view, _contacts_person_contact view (read only),
_contacts_person_grouprel view (read only), _contacts_person_group_assigned view (read only)
and _contacts_person_group_not_assigned view (read only)

Parameters:

[in]	query	The query handle to filter
[in]	keyword	The keyword
[in]	offset	The index from which to get results
[in]	limit	The number to limit results(value 0 used for get all records)
[out]	record_list	The record list

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_OUT_OF_MEMORY	Out of memory
CONTACTS_ERROR_INVALID_PARAMETER	Invalid parameter
CONTACTS_ERROR_FILE_NO_SPACE	FS Full
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_DB	Database operation failure
CONTACTS_ERROR_IPC	IPC error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

See also:

contacts_connect()

contacts_list_destroy()

Finds records based on a keyword and range.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.read

Remarks:

You must release record_list using contacts_list_destroy().
This API works only for _contacts_person view, _contacts_person_contact view (read only),
_contacts_person_grouprel view (read only), _contacts_person_group_assigned view (read only),
_contacts_person_group_not_assigned view (read only). These views can search records with range CONTACTS_SEARCH_RANGE_NAME, CONTACTS_SEARCH_RANGE_NUMBER, CONTACTS_SEARCH_RANGE_DATA.
_contacts_person_number view (read only) can search records with CONTACTS_SEARCH_RANGE_NAME and CONTACTS_SEARCH_RANGE_NUMBER.
_contacts_person_email view (read only) can search records with CONTACTS_SEARCH_RANGE_NAME and CONTACTS_SEARCH_RANGE_EMAIL.

Parameters:

[in]	view_uri	The view URI
[in]	keyword	The keyword
[in]	offset	The index from which to get results
[in]	limit	The number to limit results(value 0 is used for get all records)
[in]	range	The search range
[out]	record_list	The record list

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_OUT_OF_MEMORY	Out of memory
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_DB	Database operation failure
CONTACTS_ERROR_IPC	IPC error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

See also:

contacts_connect()

contacts_list_destroy()

Updates a record in the contacts database.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.write

Privilege:

http://tizen.org/privilege/callhistory.write

Remarks:

http://tizen.org/privilege/contact.write is needed for record which is related to _contacts_address_book view, _contacts_contact view,
_contacts_group view, _contacts_my_profile view, _contacts_name view, _contacts_number view,
_contacts_email view, _contacts_address view, _contacts_note view, _contacts_url view,
_contacts_event view, _contacts_image view, _contacts_company view, _contacts_nickname view,
_contacts_messenger view, _contacts_extension view, _contacts_profile view, _contacts_relationship view,
_contacts_activity view, _contacts_activity_photo view, _contacts_speeddial view.

http://tizen.org/privilege/callhistory.write is needed for record which is related to _contacts_phone_log view.

Parameters:

[in]

record

The record handle

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_OUT_OF_MEMORY	Out of memory
CONTACTS_ERROR_INVALID_PARAMETER	Invalid parameter
CONTACTS_ERROR_FILE_NO_SPACE	FS Full
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_DB	Database operation failure
CONTACTS_ERROR_IPC	IPC error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

Postcondition:

contacts_db_changed_cb() callback wil be called upon success.

See also:

contacts_connect()

contacts_db_insert_record()

contacts_db_delete_record()

contacts_db_get_record()

Updates multiple records in the contacts database.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/contact.write

Privilege:

http://tizen.org/privilege/callhistory.write

Remarks:

http://tizen.org/privilege/contact.write is needed for record which is related to _contacts_address_book view, _contacts_contact view,
_contacts_group view, _contacts_my_profile view, _contacts_name view, _contacts_number view,
_contacts_email view, _contacts_address view, _contacts_note view, _contacts_url view,
_contacts_event view, _contacts_image view, _contacts_company view, _contacts_nickname view,
_contacts_messenger view, _contacts_extension view, _contacts_profile view, _contacts_relationship view,
_contacts_activity view, _contacts_activity_photo view, _contacts_speeddial view.

http://tizen.org/privilege/callhistory.write is needed for record which is related to _contacts_phone_log view.

Parameters:

[in]

record_list

The record list handle

Returns:

0 on success, otherwise a negative error value

Return values:

CONTACTS_ERROR_NONE	Successful
CONTACTS_ERROR_OUT_OF_MEMORY	Out of memory
CONTACTS_ERROR_INVALID_PARAMETER	Invalid parameter
CONTACTS_ERROR_FILE_NO_SPACE	FS Full
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_DB	Database operation failure
CONTACTS_ERROR_IPC	IPC error

Precondition:

contacts_connect() should be called to open a connection to the contacts service.

Postcondition:

contacts_db_changed_cb() callback wil be called upon success.

See also:

contacts_connect()

contacts_db_insert_records()

contacts_db_delete_records()