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