Interface ConnectionHoldHandlesCb

Hierarchy

ConnectionHoldHandlesCb

Callable

ConnectionHoldHandlesCb(connection: TelepathyGLib.Connection, handle_type: HandleType, n_handles: number, handles: number, error: GLib.Error, weak_object: GObject.Object): void

- Defined in @types/Gjs/TelepathyGLib-0.12.d.ts:4076
Signature of the callback called when tp_connection_hold_handles() succeeds or fails.

On success, the caller has a reference to each handle in handles.

Since telepathy-glib version 0.13.8, the handles will remain valid until connection becomes invalid (signalled by #TpProxy::invalidated). In earlier versions, they could be released with tp_connection_unref_handles().

For convenience, the handle type and handles requested by the caller are passed through to this callback on success, so the caller does not have to include them in user_data.

Parameters
- connection: TelepathyGLib.Connection
  
  the connection
- handle_type: HandleType
  
  the handle type that was passed to tp_connection_hold_handles()
- n_handles: number
  
  the number of handles that were passed to tp_connection_hold_handles() on success, or 0 on failure
- handles: number
  
  a copy of the array of n_handles handles that was passed to tp_connection_hold_handles() on success, or %NULL on failure
- error: GLib.Error
  
  %NULL on success, or an error on failure
- weak_object: GObject.Object
  
  the same object that was passed to tp_connection_hold_handles()
Returns void