The connection
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
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
A hash table in which the keys are IDs and the values are errors (#GError)
%NULL on success, or an unrecoverable error that caused everything to fail
the weak_object that was passed to tp_connection_get_contacts_by_id()
Signature of a callback used to receive the result of tp_connection_get_contacts_by_id().
requested_idscontains 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
idspassed to tp_connection_get_contacts_by_id() were not valid, this is not considered to be a fatal error.errorwill be %NULL in this situation,contactswill contain contact objects for those IDs that were valid (it may be empty), andfailed_id_errorswill 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
connectionbecomes disconnected) the whole operation fails, and no contacts or requested IDs are returned.failed_id_errorswill 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 oferror).