ConnectionContactsByHandleCb

Description:

[ CCode ( instance_pos = 4.9 ) ]
[ Version ( since = "0.7.18" ) ]
public delegate void ConnectionContactsByHandleCb (Connection connection, Contact[] contacts, Handle[] failed, Error error, Object weak_object)

Signature of a callback used to receive the result of 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 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	The connection
contacts	An array of `contacts.length` TpContact objects (this callback is not given a reference to any of these objects, and must call @ref on any that it will keep), or `null` on unrecoverable errors
failed	An array of `failed.length` handles that were passed to get_contacts_by_handle but turned out to be invalid (or on unrecoverable errors, all the handles that were given)
error	`null` on success, or an unrecoverable error that caused everything to fail
weak_object	the `weak_object` that was passed to get_contacts_by_handle
n_contacts	The number of TpContact objects successfully created (one per valid handle), or 0 on unrecoverable errors
n_failed	The number of invalid handles that were passed to get_contacts_by_handle (or on unrecoverable errors, the total number of handles that were given)
user_data	the `user_data` that was passed to get_contacts_by_handle

Namespace: TelepathyGLib

Package: telepathy-glib