Method
EDataBookBookSqliteadd_contacts
since: 3.12
Declaration [src]
gboolean
e_book_sqlite_add_contacts (
EBookSqlite* ebsql,
GSList* contacts,
GSList* extra,
gboolean replace,
GCancellable* cancellable,
GError** error
)
Description [src]
Adds or replaces contacts in ebsql. If replace_existing is specified then existing
contacts with the same UID will be replaced, otherwise adding an existing contact
will return an error.
If extra is specified, it must have an equal length as the contacts list. Each element
from the extra list will be stored in association with it’s corresponding contact
in the contacts list.
Available since: 3.12
Parameters
contacts-
Type: A list of
EContact*A list of contacts to add to
ebsql.The data is owned by the caller of the method. extra-
Type: A list of
utf8A list of extra data to store in association with this contact.
The argument can be NULL.The data is owned by the caller of the method. Each element is a NUL terminated UTF-8 string. replace-
Type:
gbooleanWhether this contact should replace another contact with the same UID.
cancellable-
Type:
GCancellableA
GCancellable.The argument can be NULL.The data is owned by the caller of the method. error-
Type:
GError **The return location for a recoverable error.
The argument can be NULL.If the return location is not NULL, then you must initialize it to aNULLGError*.The argument will be left initialized to NULLby the method if there are no errors.In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.