Searches this for contacts matching the search expression indicated by sexp.
When sexp refers only to ContactFields configured in
the summary of this, the search should always be quick, when searching for other
ContactFields a fallback will be used, possibly invoking any
bSqlVCardCallback which may have been passed to
BookSqlite.full.
The returned ret_list list should be freed with g_slist_free and all elements freed with
search_data_free.
If meta_contact is specified, then shallow vcard representations will be created holding only the
e_contact_uid and e_contact_rev fields.
| this |
An BookSqlite |
| sexp |
search expression; use null or an empty string to list all stored contacts. |
| meta_contacts |
Whether entire contacts are desired, or only the metadata |
| ret_list |
Return location to store a SList of bSqlSearchData structures |
| cancellable |
|
true on success, otherwise false is returned and throws is set appropriately. |