upgrade_contacts


Description:

[ Version ( deprecated = true , since = "0.7.18" ) ]
public void upgrade_contacts (Contact[] contacts, ContactFeature[] features, owned ConnectionUpgradeContactsCb callback, Object? weak_object)

Warning: upgrade_contacts is deprecated.

Given several Contact objects, make asynchronous method calls ensure that all the features specified in features are ready for use (if they are supported at all).

Note:

Use upgrade_contacts_async 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

contacts

An array of Contact objects associated with this

features

An array of features that must be ready for use (if supported) before the callback is called

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_contacts

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

n_features

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

user_data

Data to pass to the callback