ensure_contact

Description:

public Contact ensure_contact (Connection connection, Handle handle, string identifier)

Returns a Contact representing identifier (and handle) on connection.

The returned Contact is cached; the same Contact object will be returned by this function repeatedly, as long as at least one reference exists.

Note that the returned Contact is not guaranteed to be ready; the caller is responsible for calling upgrade_contacts with the desired features (as given by dup_contact_features ).

For this function to work properly, has_immortal_handles must return true for connection.

Parameters:

this	a SimpleClientFactory object
connection	a Connection whose factory is this object
handle	a Handle
identifier	a string representing the contact's identifier

Returns:

a reference to a Contact.