Tizen Native API
|
Functions | |
int | contacts_vcard_parse_to_contact_foreach (const char *vcard_file_path, contacts_vcard_parse_cb callback, void *user_data) |
Retrieves all contacts with a record handle (_contacts_contact) from a vCard file. | |
int | contacts_vcard_parse_to_contacts (const char *vcard_stream, contacts_list_h *contacts_list) |
Retrieves all contacts with a contacts list from a vCard stream. | |
int | contacts_vcard_make_from_contact (contacts_record_h contact, char **vcard_stream) |
Retrieves the vCard stream from a contact. | |
int | contacts_vcard_make_from_my_profile (contacts_record_h my_profile, char **vcard_stream) |
Retrieves the vCard stream from a contact. | |
int | contacts_vcard_make_from_person (contacts_record_h person, char **vcard_stream) |
Retrieves the vCard stream from a person. | |
int | contacts_vcard_get_entity_count (const char *vcard_file_path, int *count) |
Retrieves the count of contact entities from a vCard file. | |
Typedefs | |
typedef bool(* | contacts_vcard_parse_cb )(contacts_record_h record, void *user_data) |
Called to get a record handle of _contacts_contact view. |
The contacts record API provides the set of definitions and interfaces that enable application developers to get/set data from/to vCard.
Required Header
#include <contacts.h>
Typedef Documentation
typedef bool(* contacts_vcard_parse_cb)(contacts_record_h record, void *user_data) |
Called to get a record handle of _contacts_contact view.
- Since :
- 2.3
- Parameters:
-
[in] record The record handle [in] user_data The user data passed from the foreach function
- Returns:
true
to continue with the next iteration of the loop, otherwisefalse
to break out of the loop
- Precondition:
- contacts_vcard_parse_to_contact_foreach() will invoke this callback.
Function Documentation
int contacts_vcard_get_entity_count | ( | const char * | vcard_file_path, |
int * | count | ||
) |
Retrieves the count of contact entities from a vCard file.
- Since :
- 2.3
- Parameters:
-
[in] vcard_file_path The person record handle [out] count The count of contact entity
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
CONTACTS_ERROR_NONE Successful CONTACTS_ERROR_INVALID_PARAMETER Invalid parameter CONTACTS_ERROR_SYSTEM System error
int contacts_vcard_make_from_contact | ( | contacts_record_h | contact, |
char ** | vcard_stream | ||
) |
Retrieves the vCard stream from a contact.
- Since :
- 2.3
- Parameters:
-
[in] contact The contact record handle [out] vcard_stream The vCard stream
- 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
int contacts_vcard_make_from_my_profile | ( | contacts_record_h | my_profile, |
char ** | vcard_stream | ||
) |
Retrieves the vCard stream from a contact.
- Since :
- 2.3
- Parameters:
-
[in] my_profile The my_profile record handle [out] vcard_stream The vCard stream
- 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
int contacts_vcard_make_from_person | ( | contacts_record_h | person, |
char ** | vcard_stream | ||
) |
Retrieves the vCard stream from a person.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/contact.read
- Parameters:
-
[in] person The person record handle [out] vcard_stream The vCard stream
- 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_DB DB error CONTACTS_ERROR_IPC IPC error
- Precondition:
- contacts_connect() should be called to initialize.
int contacts_vcard_parse_to_contact_foreach | ( | const char * | vcard_file_path, |
contacts_vcard_parse_cb | callback, | ||
void * | user_data | ||
) |
Retrieves all contacts with a record handle (_contacts_contact) from a vCard file.
- Since :
- 2.3
- Parameters:
-
[in] vcard_file_path The file path of vCard stream file [in] callback The callback function to invoke [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_NO_DATA Requested data does not exist CONTACTS_ERROR_SYSTEM System error
- Precondition:
- contacts_connect() should be called to initialize.
- Postcondition:
- This function invokes contacts_vcard_parse_cb().
- See also:
- contacts_vcard_parse_cb()
int contacts_vcard_parse_to_contacts | ( | const char * | vcard_stream, |
contacts_list_h * | contacts_list | ||
) |
Retrieves all contacts with a contacts list from a vCard stream.
- Since :
- 2.3
- Parameters:
-
[in] vcard_stream The vCard stream [out] contacts_list The contacts 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
- Precondition:
- contacts_connect() should be called to initialize.