[ Version ( since = "3.8" ) ]
public static Client? connect_sync (Source source, ClientSourceType source_type, uint32 wait_for_connected_seconds, Cancellable? cancellable = null) throws Error
Creates a new Client for source and source_type.
If an error occurs, the function will set throws and return false.
The wait_for_connected_seconds argument had been added since 3.16, to let the caller decide how long to wait for the backend
to fully connect to its (possibly remote) data store. This is required due to a change in the authentication process, which is fully
asynchronous and done on the client side, while not every client is supposed to response to authentication requests. In case the backend
will not connect within the set interval, then it is opened in an offline mode. A special value -1 can be used to not wait for the
connected state at all.
Unlike with Client, there is no need to call open_sync after obtaining the Client.
For error handling convenience, any error message returned by this function will have a descriptive prefix that includes the display name
of source.
| source |
an Source |
| source_type |
source type of the calendar |
| wait_for_connected_seconds |
timeout, in seconds, to wait for the backend to be fully connected |
| cancellable |
optional Cancellable object, or null |
|
a new Client, or null |