| Evolution API Reference: libebook, the Addressbook Library | ||||
|---|---|---|---|---|
| Top | Description | ||||
void (*EBookCallback) (EBook *book, EBookStatus status, gpointer closure); void (*EBookOpenProgressCallback) (EBook *book, const char *status_message, short percent , gpointer closure); void (*EBookIdCallback) (EBook *book, EBookStatus status, const char *id, gpointer closure); void (*EBookContactCallback) (EBook *book, EBookStatus status, EContact *contact, gpointer closure); void (*EBookBookViewCallback) (EBook *book, EBookStatus status, EBookView *book_view, gpointer closure); guint e_book_async_get_supported_fields (EBook *book, EBookEListCallback cb, gpointer closure); guint e_book_async_get_supported_auth_methods (EBook *book, EBookEListCallback cb, gpointer closure); guint e_book_async_authenticate_user (EBook *book, const char *user, const char *passwd, const char *auth_method, EBookCallback cb, gpointer closure); guint e_book_async_get_contact (EBook *book, const char *id, EBookContactCallback cb, gpointer closure); guint e_book_async_get_contacts (EBook *book, EBookQuery *query, EBookListCallback cb, gpointer closure); guint e_book_async_remove_contact (EBook *book, EContact *contact, EBookCallback cb, gpointer closure); guint e_book_async_remove_contact_by_id (EBook *book, const char *id, EBookCallback cb, gpointer closure); guint e_book_async_remove_contacts (EBook *book, GList *ids, EBookCallback cb, gpointer closure); gboolean e_book_async_add_contact (EBook *book, EContact *contact, EBookIdCallback cb, gpointer closure); guint e_book_async_commit_contact (EBook *book, EContact *contact, EBookCallback cb, gpointer closure); guint e_book_async_get_book_view (EBook *book, EBookQuery *query, GList *requested_fields, int max_results, EBookBookViewCallback cb, gpointer closure);
void (*EBookCallback) (EBook *book, EBookStatus status, gpointer closure);
|
|
|
|
|
void (*EBookOpenProgressCallback) (EBook *book, const char *status_message, short percent , gpointer closure);
|
|
|
|
|
|
|
void (*EBookIdCallback) (EBook *book, EBookStatus status, const char *id, gpointer closure);
|
|
|
|
|
|
|
void (*EBookContactCallback) (EBook *book, EBookStatus status, EContact *contact, gpointer closure);
|
|
|
|
|
|
|
void (*EBookBookViewCallback) (EBook *book, EBookStatus status, EBookView *book_view, gpointer closure);
|
|
|
|
|
|
|
guint e_book_async_get_supported_fields (EBook *book, EBookEListCallback cb, gpointer closure);
Gets a list of fields that can be stored for contacts
in this book. Other fields may be discarded. This
function does not block.
guint e_book_async_get_supported_auth_methods (EBook *book, EBookEListCallback cb, gpointer closure);
Queries book for the list of authentication methods it supports.
This function does not block.
guint e_book_async_authenticate_user (EBook *book, const char *user, const char *passwd, const char *auth_method, EBookCallback cb, gpointer closure);
Authenticate user with passwd, using the auth method
auth_method. auth_method must be one of the authentication
methods returned using e_book_get_supported_auth_methods.
This function does not block.
guint e_book_async_get_contact (EBook *book, const char *id, EBookContactCallback cb, gpointer closure);
Retrieves a contact specified by id from book.
guint e_book_async_get_contacts (EBook *book, EBookQuery *query, EBookListCallback cb, gpointer closure);
Query book with query.
|
an EBook |
|
an EBookQuery |
|
a function to call when the operation finishes |
|
data to pass to callback function |
Returns : |
FALSE on success, TRUE otherwise
|
guint e_book_async_remove_contact (EBook *book, EContact *contact, EBookCallback cb, gpointer closure);
Removes contact from book.
guint e_book_async_remove_contact_by_id (EBook *book, const char *id, EBookCallback cb, gpointer closure);
Removes the contact with id id from book.
guint e_book_async_remove_contacts (EBook *book, GList *ids, EBookCallback cb, gpointer closure);
Removes the contacts with ids from the list ids from book. This is
always more efficient than calling e_book_remove_contact_by_id() if you
have more than one id to remove, as some backends can implement it
as a batch request.
gboolean e_book_async_add_contact (EBook *book, EContact *contact, EBookIdCallback cb, gpointer closure);
Adds contact to book without blocking.
guint e_book_async_commit_contact (EBook *book, EContact *contact, EBookCallback cb, gpointer closure);
Applies the changes made to contact to the stored version in
book without blocking.
guint e_book_async_get_book_view (EBook *book, EBookQuery *query, GList *requested_fields, int max_results, EBookBookViewCallback cb, gpointer closure);
Query book with query, creating a EBookView with the fields
specified by requested_fields and limited at max_results records.
|
an EBook |
|
an EBookQuery |
|
a GList containing the names of fields to return, or NULL for all |
|
the maximum number of contacts to show (or 0 for all) |
|
a function to call when the operation finishes |
|
data to pass to callback function |
Returns : |
FALSE if successful, TRUE otherwise
|