ConnectionContactsByIdCb
Description:
[ Version ( since = "0.7.18" ) ]
public delegate void ConnectionContactsByIdCb (Connection connection, Contact[] contacts, string[] requested_ids, HashTable<string,Error> failed_id_errors, Error error, Object weak_object)
Signature of a callback used to receive the result of 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
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 Error (if the connection manager complies with the Telepathy spec, it will
have domain Error and code
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
Error (either one indicating that the ID was invalid, if that was determined before the
fatal error occurred, or a copy of error).
Parameters:
| connection |
The connection |
| contacts |
An array of |
| requested_ids |
An array of |
| failed_id_errors |
A hash table in which the keys are IDs and the values are errors (#GError) |
| error |
|
| weak_object |
the |
| n_contacts |
The number of TpContact objects successfully created (one per valid ID), or 0 on unrecoverable errors |
| user_data |
the |