dup_contact_by_id_async


Description:

[ Version ( since = "0.19.0" ) ]
public async Contact dup_contact_by_id_async (string id, ContactFeature[]? features) throws Error

Create a Contact object and make any asynchronous method calls necessary to ensure that all the features specified in features are ready for use (if they are supported at all).

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

id

A strings representing the desired contact by its identifier in the IM protocol (an XMPP JID, SIP URI, MSN Passport, AOL screen-name 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 contact is ready

n_features

The number of features in features (may be 0)

user_data

Data to pass to the callback