Warning: get_contact_list_attributes is deprecated.
Return (via a callback) the contacts on the contact list and any number of their attributes.
Use dup_contact_list instead.
Since telepathy-glib version 0.13.8, the handles will remain valid until connection
becomes invalid (signalled by
invalidated). In earlier versions, if hold
was true
, the callback would hold a reference to them which could be released with
unref_handles.
This is a thin wrapper around the RequestContactList D-Bus method, and should be used in preference to lower-level functions; it is similar to get_contact_attributes.
The Contact API provides a higher-level abstraction which should usually be used instead.
If hold
is true
, the callback
is given a reference to each handle that appears as a key in the
callback's attributes
parameter.
this |
a connection |
timeout_ms |
the timeout in milliseconds (using a large timeout is recommended) |
interfaces |
a |
hold |
if |
callback |
called on success or failure (unless |
weak_object |
if not |
destroy |
called to destroy |
user_data |
arbitrary user-supplied data |