BaseConnectionStartConnectingImpl


Description:

[ CCode ( has_target = false ) ]
public delegate bool BaseConnectionStartConnectingImpl (BaseConnection self) throws Error

Signature of an implementation of the start_connecting method of BaseConnection.

On entry, the implementation may assume that it is in state NEW.

If true is returned, the Connect D-Bus method succeeds; the implementation must either have already set the status to CONNECTED by calling change_status, or have arranged for a status change to either state DISCONNECTED or CONNECTED to be signalled by calling change_status at some later time. If the status is still NEW after returning true, BaseConnection will automatically change it to CONNECTING for reason REQUESTED.

If false is returned, the error will be raised from Connect as an exception. If the status is not DISCONNECTED after false is returned, BaseConnection will automatically change it to DISCONNECTED with a reason appropriate to the error; NetworkError results in NETWORK_ERROR, PermissionDenied results in AUTHENTICATION_FAILED, and all other errors currently result in NONE_SPECIFIED.

All except the simplest connection managers are expected to implement this asynchronously, returning true in most cases and changing the status to CONNECTED or DISCONNECTED later.

Parameters:

self

The connection object

Returns:

false if failure has already occurred, else true.


Namespace: TelepathyGLib
Package: telepathy-glib