Interface ConnectionContactsByHandleCb

Hierarchy

ConnectionContactsByHandleCb

Callable

ConnectionContactsByHandleCb(connection: TelepathyGLib.Connection, contacts: TelepathyGLib.Contact[], failed: number[], error: GLib.Error, weakObject: GObject.Object): void

- Defined in TelepathyGLib-0.12.d.ts:4016
Signature of a callback used to receive the result of tp_connection_get_contacts_by_handle().

If an unrecoverable error occurs (for instance, if connection becomes disconnected) the whole operation fails, and no contacts or invalid handles are returned.

If some or even all of the handles passed to tp_connection_get_contacts_by_handle() were not valid, this is not considered to be a failure. error will be %NULL in this situation, contacts will contain contact objects for those handles that were valid (possibly none of them), and invalid will contain the handles that were not valid.

Parameters
- connection: TelepathyGLib.Connection
  
  The connection
- contacts: TelepathyGLib.Contact[]
  
  An array of n_contacts TpContact objects (this callback is not given a reference to any of these objects, and must call g_object_ref() on any that it will keep), or %NULL on unrecoverable errors
- failed: number[]
  
  An array of n_failed handles that were passed to tp_connection_get_contacts_by_handle() but turned out to be invalid (or on unrecoverable errors, all the handles that were given)
- error: GLib.Error
  
  %NULL on success, or an unrecoverable error that caused everything to fail
- weakObject: GObject.Object
  
  the weak_object that was passed to tp_connection_get_contacts_by_handle()
Returns void