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.
self |
The connection object |
|