Allows to reconnect the given connection, using actual connection settings.
Given a connection that is actually broken, this function can be used to reconnect it trying to find, on the same host and port, the peer that the connection was linked to.
The connection "reconnected" will keep the connection identifier, any data set on this connection using the vortex_connection_set_data and vortex_connection_set_data_full functions, the connection reference count and remote profiles read.
If the function detect that the given connection is currently working and connected then the function does nothing.
Here is an example:
|connection ||The connection to reconnect to.|
|on_connected ||Optional handler. This function works as vortex_connection_new. This handler can be defined to notify when the connection has been reconnected.|
|user_data ||User defined data to be passed to on_connected.|
- TRUE if the connection was successfully reconnected or FALSE if not. If the on_connected handler is defined, this function will always return TRUE.