Gjsify LogoGjsify Logo

Hierarchy

  • ConnectionContactsByIdCb

Callable

  • Signature of a callback used to receive the result of tp_connection_get_contacts_by_id().

    requested_ids contains the IDs that were converted to handles successfully. The normalized form of requested_ids[i] is tp_contact_get_identifier (contacts[i]).

    If some or even all of the ids passed to tp_connection_get_contacts_by_id() were not valid, this is not considered to be a fatal error. error will be %NULL in this situation, contacts will contain contact objects for those IDs that were valid (it may be empty), and failed_id_errors will map the IDs that were not valid to a corresponding #GError (if the connection manager complies with the Telepathy spec, it will have domain %TP_ERROR and code %TP_ERROR_INVALID_HANDLE).

    If an unrecoverable error occurs (for instance, if connection becomes disconnected) the whole operation fails, and no contacts or requested IDs are returned. failed_id_errors will contain all the IDs that were requested, mapped to a corresponding #GError (either one indicating that the ID was invalid, if that was determined before the fatal error occurred, or a copy of error).

    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

    • requestedIds: string[]

      An array of n_contacts valid IDs (JIDs, SIP URIs etc.) that were passed to tp_connection_get_contacts_by_id(), in an order corresponding to contacts, or %NULL on unrecoverable errors

    • failedIdErrors: HashTable<string | number | symbol, string | number | boolean>

      A hash table in which the keys are IDs and the values are errors (#GError)

    • 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_id()

    Returns void

Legend

  • Module
  • Object literal
  • Variable
  • Function
  • Function with type parameter
  • Index signature
  • Type alias
  • Type alias with type parameter
  • Enumeration
  • Enumeration member
  • Property
  • Method
  • Interface
  • Interface with type parameter
  • Constructor
  • Property
  • Method
  • Index signature
  • Class
  • Class with type parameter
  • Constructor
  • Property
  • Method
  • Accessor
  • Index signature
  • Inherited constructor
  • Inherited property
  • Inherited method
  • Inherited accessor
  • Protected property
  • Protected method
  • Protected accessor
  • Private property
  • Private method
  • Private accessor
  • Static property
  • Static method