Queries the this for a summary_field value for contacts in the given range and order.
To get complete contacts use dup_query_contacts. Note the field value may not correspond precisely to the value stored in the vCard (it can be in lower case).
Both summary_field and sort_field should be in the summary, otherwise an error is returned.
The out_uids and out_values will have the same number of elements, the indexes corresponding to each other.
Free the arrays with g_ptr_aray_unref, when no longer needed.
| this |
an BookCache |
| summary_field |
a field to query, which should be in the summary |
| sexp |
search expression; use null or an empty string to consider all stored contacts |
| sort_field |
a field to sort by, which should be in the summary |
| sort_type | |
| n_offset |
a 0-based offset in the sorted result to start reading from, or 0 to read from start |
| n_limit |
how many values to return only; use 0 or G_MAXUINT to read everything from the |
| out_uids |
contact UID-s in the requested order |
| out_values |
|
| cancellable |
|
Whether succeeded. |