hold_handles


Description:

[ Version ( deprecated = true ) ]
public void hold_handles (int timeout_ms, HandleType handle_type, Handle[] handles, owned ConnectionHoldHandlesCb callback, Object weak_object)

Warning: hold_handles is deprecated.

Hold (ensure a reference to) the given handles, if they are valid.

Note:

Holding handles is not needed with Connection Managers having immortal handles (any Connection Manager using telepathy-glib >= 0.13.8).

Other Connection Managers are considered deprecated, clients wanting to still support them should continue using this deprecated function.

If they are valid, the callback will later be called with the given handles; if not all of them are valid, the callback will be called with an error.

This function, along with unref_handles, get_contact_attributes and Contact, keeps a client-side reference count of handles; you should not use the RequestHandles, HoldHandles and GetContactAttributes D-Bus methods directly as well as these functions.

Parameters:

this

a connection

timeout_ms

the timeout in milliseconds, or -1 to use the default

handle_type

the handle type

handles

an array of handles

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)

n_handles

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

user_data

arbitrary user-supplied data