request_handles


Description:

[ Version ( deprecated = true ) ]
public void request_handles (int timeout_ms, HandleType handle_type, string[] ids, owned ConnectionRequestHandlesCb callback, Object weak_object)

Warning: request_handles is deprecated.

Request the handles corresponding to the given identifiers, and if they are valid, hold (ensure a reference to) the corresponding handles.

Note:

If handle_type is TP_HANDLE_TYPE_CONTACT, use dup_contact_by_id_async instead.

For channel requests, use set_target_id instead.

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.

Parameters:

this

a connection

timeout_ms

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

handle_type

the handle type

ids

an array of string identifiers for which handles are required, terminated by null (must not be null or empty)

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)

user_data

arbitrary user-supplied data