|
Tizen Native API
4.0
|
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:
0on 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.
| 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:
0on 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.
| 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:
0on 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()