get_contacts_by_handle


Description:

[ Version ( deprecated = true , since = "0.7.18" ) ]
public void get_contacts_by_handle (uint[] handles, uint[]? features, owned ConnectionContactsByHandleCb callback, Object? weak_object)

Warning: get_contacts_by_handle is deprecated.

Create a number of Contact objects and make asynchronous method calls to hold their handles and ensure that all the features specified in features are ready for use (if they are supported at all).

Note:

Use ensure_contact instead.

It is not an error to put features in features even if the connection manager doesn't support them - users of this method should have a static list of features they would like to use if possible, and use it for all connection managers.

Parameters:

this

A connection, which must have the TP_CONNECTION_FEATURE_CONNECTED feature prepared

handles

An array of handles of type CONTACT representing the desired contacts

features

An array of features that must be ready for use (if supported) before the callback is called (may be null if features.length is 0)

callback

A user callback to call when the contacts are ready

weak_object

An object to pass to the callback, which will be weakly referenced; if this object is destroyed, the operation will be cancelled

destroy

Called to destroy user_data either after callback has been called, or if the operation is cancelled

n_features

The number of features in features (may be 0)

n_handles

The number of handles in handles (must be at least 1)

user_data

Data to pass to the callback