since: 3.0.0

Declaration [src]

purple_connection_connect (
  PurpleConnection* connection
  GError** error

Description [src]

Tells the connection to connect. This is done by calling the Purple.ConnectionClass.connect function. State is managed by this function.

The default Purple.ConnectionClass.connect is to call Purple.ProtocolClass.login.

Due to the asynchronous nature of network connections, the return value and error are to be used to do some initial validation before a connection is actually attempted.

Available since: 3.0.0

Return value

Type: gboolean

TRUE if the initial connection for account was successful, otherwise FALSE with error possibly set.