EBook

typedef struct _EBook EBook;

EBook has no publicly available members.

e_book_new ()

EBook*      e_book_new                      (ESource *source,
                                             GError **error);

Creates a new EBook corresponding to the given source. There are only two operations that are valid on this book at this point: e_book_open(), and e_book_remove().

e_book_new_default_addressbook ()

EBook*      e_book_new_default_addressbook  (GError **error);

Creates a new EBook corresponding to the user's default addressbook. See the documentation for e_book_new for further information.

e_book_new_from_uri ()

EBook*      e_book_new_from_uri             (const char *uri,
                                             GError **error);

Creates a new EBook corresponding to the given uri. See the documentation for e_book_new for further information.

e_book_new_system_addressbook ()

EBook*      e_book_new_system_addressbook   (GError **error);

Creates a new EBook corresponding to the user's system addressbook. See the documentation for e_book_new for further information.

e_book_set_default_addressbook ()

gboolean    e_book_set_default_addressbook  (EBook *book,
                                             GError **error);

sets the ESource of the EBook as the "default" addressbook. This is the source that will be loaded in the e_book_get_default_addressbook call.

e_book_set_default_source ()

gboolean    e_book_set_default_source       (ESource *source,
                                             GError **error);

sets source as the "default" addressbook. This is the source that will be loaded in the e_book_get_default_addressbook call.

e_book_remove ()

gboolean    e_book_remove                   (EBook *book,
                                             GError **error);

Removes the backing data for this EBook. For example, with the file backend this deletes the database file. You cannot get it back!

e_book_open ()

gboolean    e_book_open                     (EBook *book,
                                             gboolean only_if_exists,
                                             GError **error);

Opens the addressbook, making it ready for queries and other operations.

e_book_get_supported_fields ()

gboolean    e_book_get_supported_fields     (EBook *book,
                                             GList **fields,
                                             GError **error);

Gets a list of fields that can be stored for contacts in this book. Other fields may be discarded. The list will contain pointers to allocated strings, and both the GList and the strings must be freed by the caller.

e_book_get_supported_auth_methods ()

gboolean    e_book_get_supported_auth_methods
                                            (EBook *book,
                                             GList **auth_methods,
                                             GError **error);

Queries book for the list of authentication methods it supports. The list will contain pointers to allocated strings, and both the GList and the strings must be freed by the caller.

e_book_get_required_fields ()

gboolean    e_book_get_required_fields      (EBook *book,
                                             GList **fields,
                                             GError **error);

Gets a list of fields that are required to be filled in for all contacts in this book. The list will contain pointers to allocated strings, and both the GList and the strings must be freed by the caller.

e_book_get_source ()

ESource*    e_book_get_source               (EBook *book);

Get the ESource that this book has loaded.

e_book_is_online ()

gboolean    e_book_is_online                (EBook *book);

Check if this book is connected.

e_book_is_opened ()

gboolean    e_book_is_opened                (EBook *book);

Check if this book has been opened.

e_book_authenticate_user ()

gboolean    e_book_authenticate_user        (EBook *book,
                                             const char *user,
                                             const char *passwd,
                                             const char *auth_method,
                                             GError **error);

Authenticates 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.

e_book_get_contact ()

gboolean    e_book_get_contact              (EBook *book,
                                             const char *id,
                                             EContact **contact,
                                             GError **error);

Fills in contact with the contents of the vcard in book corresponding to id.

e_book_remove_contact ()

gboolean    e_book_remove_contact           (EBook *book,
                                             const char *id,
                                             GError **error);

Removes the contact with id id from book.

e_book_remove_contacts ()

gboolean    e_book_remove_contacts          (EBook *book,
                                             GList *ids,
                                             GError **error);

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.

e_book_add_contact ()

gboolean    e_book_add_contact              (EBook *book,
                                             EContact *contact,
                                             GError **error);

Adds contact to book.

e_book_commit_contact ()

gboolean    e_book_commit_contact           (EBook *book,
                                             EContact *contact,
                                             GError **error);

Applies the changes made to contact to the stored version in book.

e_book_get_book_view ()

gboolean    e_book_get_book_view            (EBook *book,
                                             EBookQuery *query,
                                             GList *requested_fields,
                                             int max_results,
                                             EBookView **book_view,
                                             GError **error);

Query book with query, creating a EBookView in book_view with the fields specified by requested_fields and limited at max_results records. On an error, error is set and FALSE returned.

e_book_get_contacts ()

gboolean    e_book_get_contacts             (EBook *book,
                                             EBookQuery *query,
                                             GList **contacts,
                                             GError **error);

Query book with query, setting contacts to the list of contacts which matched. On failed, error will be set and FALSE returned.

e_book_get_changes ()

gboolean    e_book_get_changes              (EBook *book,
                                             char *changeid,
                                             GList **changes,
                                             GError **error);

Get the set of changes since the previous call to e_book_get_changes for a given change ID.

e_book_free_change_list ()

void        e_book_free_change_list         (GList *change_list);

Free the contents of change_list, and the list itself.

e_book_get_uri ()

const char* e_book_get_uri                  (EBook *book);

Get the URI that this book has loaded. This string should not be freed.

e_book_get_static_capabilities ()

const char* e_book_get_static_capabilities  (EBook *book,
                                             GError **error);

Get the list of capabilities which the backend for this address book supports. This string should not be freed.

e_book_check_static_capability ()

gboolean    e_book_check_static_capability  (EBook *book,
                                             const char *cap);

Check to see if the backend for this address book supports the capability cap.

e_book_is_writable ()

gboolean    e_book_is_writable              (EBook *book);

Check if this book is writable.

e_book_cancel ()

gboolean    e_book_cancel                   (EBook *book,
                                             GError **error);

Used to cancel an already running operation on book. This function makes a synchronous CORBA to the backend telling it to cancel the operation. If the operation wasn't cancellable (either transiently or permanently) or had already comopleted on the server side, this function will return E_BOOK_STATUS_COULD_NOT_CANCEL, and the operation will continue uncancelled. If the operation could be cancelled, this function will return E_BOOK_ERROR_OK, and the blocked e_book function corresponding to current operation will return with a status of E_BOOK_STATUS_CANCELLED.

e_book_get_self ()

gboolean    e_book_get_self                 (EContact **contact,
                                             EBook **book,
                                             GError **error);

Get the EContact referring to the user of the address book and set it in contact and book.

e_book_set_self ()

gboolean    e_book_set_self                 (EBook *book,
                                             EContact *contact,
                                             GError **error);

Specify that contact residing in book is the EContact that refers to the user of the address book.

e_book_is_self ()

gboolean    e_book_is_self                  (EContact *contact);

Check if contact is the user of the address book.

e_book_get_addressbooks ()

gboolean    e_book_get_addressbooks         (ESourceList **addressbook_sources,
                                             GError **error);

Populate *addressbook_sources with the list of all sources which have been added to Evolution.

EBookCallback ()

void        (*EBookCallback)                (EBook *book,
                                             EBookStatus status,
                                             gpointer closure);

EBookOpenProgressCallback ()

void        (*EBookOpenProgressCallback)    (EBook *book,
                                             const char *status_message,
                                             short percent ,
                                             gpointer closure);

EBookIdCallback ()

void        (*EBookIdCallback)              (EBook *book,
                                             EBookStatus status,
                                             const char *id,
                                             gpointer closure);

EBookEListCallback ()

void        (*EBookEListCallback)           (EBook *book,
                                             EBookStatus status,
                                             EList *list,
                                             gpointer closure);

EBookListCallback ()

void        (*EBookListCallback)            (EBook *book,
                                             EBookStatus status,
                                             GList *list,
                                             gpointer closure);

EBookContactCallback ()

void        (*EBookContactCallback)         (EBook *book,
                                             EBookStatus status,
                                             EContact *contact,
                                             gpointer closure);

EBookBookViewCallback ()

void        (*EBookBookViewCallback)        (EBook *book,
                                             EBookStatus status,
                                             EBookView *book_view,
                                             gpointer closure);

e_book_async_open ()

guint       e_book_async_open               (EBook *book,
                                             gboolean only_if_exists,
                                             EBookCallback open_response,
                                             gpointer closure);

Opens the addressbook, making it ready for queries and other operations. This function does not block.

e_book_async_remove ()

guint       e_book_async_remove             (EBook *book,
                                             EBookCallback cb,
                                             gpointer closure);

Remove the backing data for this EBook. For example, with the file backend this deletes the database file. You cannot get it back!

e_book_async_get_supported_fields ()

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.

e_book_async_get_supported_auth_methods ()

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.

e_book_async_authenticate_user ()

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.

e_book_async_get_contact ()

guint       e_book_async_get_contact        (EBook *book,
                                             const char *id,
                                             EBookContactCallback cb,
                                             gpointer closure);

Retrieves a contact specified by id from book.

e_book_async_get_contacts ()

guint       e_book_async_get_contacts       (EBook *book,
                                             EBookQuery *query,
                                             EBookListCallback cb,
                                             gpointer closure);

Query book with query.

e_book_async_remove_contact ()

guint       e_book_async_remove_contact     (EBook *book,
                                             EContact *contact,
                                             EBookCallback cb,
                                             gpointer closure);

Removes contact from book.

e_book_async_remove_contact_by_id ()

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.

e_book_async_remove_contacts ()

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.

e_book_async_add_contact ()

gboolean    e_book_async_add_contact        (EBook *book,
                                             EContact *contact,
                                             EBookIdCallback cb,
                                             gpointer closure);

Adds contact to book without blocking.

e_book_async_commit_contact ()

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.

e_book_async_get_book_view ()

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.

e_book_async_get_changes ()

guint       e_book_async_get_changes        (EBook *book,
                                             char *changeid,
                                             EBookListCallback cb,
                                             gpointer closure);

Get the set of changes since the previous call to e_book_async_get_changes for a given change ID.

e_book_async_get_required_fields ()

guint       e_book_async_get_required_fields
                                            (EBook *book,
                                             EBookEListCallback cb,
                                             gpointer closure);

Gets a list of fields that are required to be filled in for all contacts in this book. This function does not block.

The "auth-required" signal

void        user_function                  (EBook   *ebook,
                                            gpointer user_data)      : Run last

Authentication is required to access this source. You should call e_book_authenticate_user or e_book_async_authenticate_user.

The "backend-died" signal

void        user_function                  (EBook   *ebook,
                                            gpointer user_data)      : Run last

The backend for this address book has died.

The "connection-status" signal

void        user_function                  (EBook   *ebook,
                                            gboolean arg1,
                                            gpointer user_data)      : Run last

The connection status for this book is being reported.

The "writable-status" signal

void        user_function                  (EBook   *ebook,
                                            gboolean arg1,
                                            gpointer user_data)      : Run last

The writable status for this book is being reported.