Group

---

The contacts group API provides the set of definitions and interfaces that enable application developers to add/remove contact as group member.

Required Header

#include <contacts.h>

Functions
int	contacts_group_add_contact (int group_id, int contact_id)
	Adds a contact and a group relationship to the contacts database.
int	contacts_group_remove_contact (int group_id, int contact_id)
	Removes a contact and a group relationship from the contacts database.
int	contacts_group_set_group_order (int group_id, int previous_group_id, int next_group_id)
	Sets a group between the previous group and the next group.

---

Function Documentation

int contacts_group_add_contact	(	int	group_id,
		int	contact_id
	)

Adds a contact and a group relationship to the contacts database.

Since :

2.3

Privilege Level:

public

Privilege:

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

Parameters:

[in]	group_id	The group ID
[in]	contact_id	The contact 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_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
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()

contacts_group_remove_contact()

int contacts_group_remove_contact	(	int	group_id,
		int	contact_id
	)

Removes a contact and a group relationship from the contacts database.

Since :

2.3

Privilege Level:

public

Privilege:

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

Parameters:

[in]	group_id	The group ID
[in]	contact_id	The contact 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_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
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()

contacts_group_add_contact()

int contacts_group_set_group_order	(	int	group_id,
		int	previous_group_id,
		int	next_group_id
	)

Sets a group between the previous group and the next group.

Since :

2.3

Privilege Level:

public

Privilege:

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

Parameters:

[in]	group_id	The group ID to move
[in]	previous_group_id	The previous group ID
[in]	next_group_id	The back group 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_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
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()