dup_contact_if_possible
Description:
public Contact dup_contact_if_possible (Handle handle, string identifier)
Try to return an existing contact object or create a new contact object immediately.
If has_immortal_handles would return true
and identifier is non-%NULL, this function always succeeds.
On connections without immortal handles, it is not possible to guarantee that handle remains valid without making asynchronous
D-Bus calls, so it might be necessary to delay processing of messages or other events until a
Contact can be constructed asynchronously, for instance by using
get_contacts_by_id.
Similarly, if identifier is null, it might not be possible to find the identifier for handle without
making asynchronous D-Bus calls, so it might be necessary to delay processing of messages or other events until a
Contact can be constructed asynchronously, for instance by using
get_contacts_by_handle.
Parameters:
| this |
a connection |
| handle |
a handle of type CONTACT |
| identifier |
the normalized identifier (XMPP JID, etc.) corresponding to |
Returns:
|
a contact or |