[ Version ( since = "0.13.9" ) ]
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.
| this |
a connection |
| handle |
a handle of type CONTACT |
| identifier |
the normalized identifier (XMPP JID, etc.) corresponding to |
|
a contact or |