Top | ![]() |
![]() |
![]() |
![]() |
|
e_client_selector_new () |
EClientCache * | e_client_selector_ref_client_cache () |
|
e_client_selector_get_client_sync () |
|
e_client_selector_get_client () |
|
e_client_selector_get_client_finish () |
|
e_client_selector_ref_cached_client () |
|
e_client_selector_ref_cached_client_by_iter () |
|
e_client_selector_is_backend_dead () |
GtkWidget * e_client_selector_new (EClientCache *client_cache
,const
);gchar *extension_name
Displays a list of sources having an extension named extension_name
,
along with status information about the backends associated with them.
The sources are grouped by backend or groupware account, which are
described by the parent source.
EClientCache *
e_client_selector_ref_client_cache (EClientSelector *selector
);
Returns the EClientCache passed to e_client_selector_new()
.
The returned EClientCache is referenced for thread-safety and must be
unreferenced with g_object_unref()
EClient * e_client_selector_get_client_sync (,
EClientSelector *selector,
ESource *source,
gboolean call_allow_auth_prompt,
guint32 wait_for_connected_seconds,
GCancellable *cancellable);
GError **error
Obtains a shared source
, or else creates a new
The e_client_cache_get_client_sync()
for a list
of valid extension names.
If a request for the same source
and
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.
Unreference the returned g_object_unref()
error
and return
NULL
selector |
an |
|
source |
an |
|
call_allow_auth_prompt |
whether call allow-auth-prompt on the source first |
|
wait_for_connected_seconds |
timeout, in seconds, to wait for the backend to be fully connected |
|
cancellable |
optional |
|
error |
return location for a |
void e_client_selector_get_client (,
EClientSelector *selector,
ESource *source,
gboolean call_allow_auth_prompt,
guint32 wait_for_connected_seconds,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Asynchronously obtains a shared source
, or else
creates a new
The e_client_cache_get_client_sync()
for a list
of valid extension names.
If a request for the same source
and
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.
When the operation is finished, callback
will be called. You can
then call e_client_selector_get_client_finish()
to get the result of
the operation.
selector |
an |
|
source |
an |
|
call_allow_auth_prompt |
whether call allow-auth-prompt on the source first |
|
wait_for_connected_seconds |
timeout, in seconds, to wait for the backend to be fully connected |
|
cancellable |
optional |
|
callback |
a |
|
user_data |
data to pass to the callback function |
EClient * e_client_selector_get_client_finish (,
EClientSelector *selector,
GAsyncResult *result);
GError **error
Finishes the operation started with e_client_selector_get_client()
.
Unreference the returned g_object_unref()
error
and return
NULL
EClient * e_client_selector_ref_cached_client (,
EClientSelector *selector);
ESource *source
Returns a shared source
and the value of
NULL
The returned g_object_unref()
EClient * e_client_selector_ref_cached_client_by_iter (,
EClientSelector *selector);
GtkTreeIter *iter
Returns a shared iter
and the value of NULL
The returned g_object_unref()
gboolean e_client_selector_is_backend_dead (,
EClientSelector *selector);
ESource *source
Returns TRUE
source
and the value of