get_contacts_by_id


Description:

[ Version ( deprecated = true , since = "0.7.18" ) ]
public void get_contacts_by_id (string[] ids, ContactFeature[]? features, owned ConnectionContactsByIdCb callback, Object? weak_object)

Warning: get_contacts_by_id is deprecated.

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

Note:

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

ids

An array of strings representing the desired contacts by their identifiers in the IM protocol (XMPP JIDs, SIP URIs, MSN Passports, AOL screen-names etc.)

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_ids

The number of IDs in ids (must be at least 1)

user_data

Data to pass to the callback