get_contact_list_attributes


Description:

[ Version ( deprecated = true ) ]
public void get_contact_list_attributes (int timeout_ms, string interfaces, bool hold, owned Callback callback, Object weak_object)

Warning: get_contact_list_attributes is deprecated.

Return (via a callback) the contacts on the contact list and any number of their attributes.

Note:

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.

Parameters:

this

a connection

timeout_ms

the timeout in milliseconds (using a large timeout is recommended)

interfaces

a GStrv of interfaces

hold

if true, the callback will hold one reference to each handle it receives

callback

called on success or failure (unless weak_object has become unreferenced)

weak_object

if not null, an object to be weakly referenced: if it is destroyed, callback will not be called

destroy

called to destroy user_data after calling callback, or when weak_object becomes unreferenced (whichever occurs sooner)

user_data

arbitrary user-supplied data