Top | ![]() |
![]() |
![]() |
![]() |
#define | E_SOURCE_PARAM_SETTING |
#define | E_SOURCE_CREDENTIAL_USERNAME |
#define | E_SOURCE_CREDENTIAL_PASSWORD |
#define | E_SOURCE_CREDENTIAL_SSL_TRUST |
struct | ESource |
An ESource (or "data source") is a description of a file or network location where data can be obtained (such as a mail account), or a description of a resource at that location (such as a mail folder).
In more concrete terms, it's an interface for a key file. All such
key files have a main group named [Data Source]. The keys in a
[Data Source] group map to
Additional groups in the key file are referred to as "extensions".
ESourceExtension serves as the base class for writing interfaces
for these additional key file groups. The keys in one of these
key file groups map to
Each ESource contains an internal dictionary of extension objects,
accessible by their key file group name. e_source_get_extension()
can look up extension objects by name.
An ESource is identified by a unique identifier string, or "UID", which is also the basename of the corresponding key file. Additional files related to the ESource, such as cache files, are usually kept in a directory named after the UID of the ESource. Similarly, the password for an account described by an ESource is kept in GNOME Keyring under the UID of the ESource. This makes finding these additional resources simple.
Several extensions for common information such as authentication details are built into libedataserver (ESourceAuthentication, for example). Backend modules may also define their own extensions for information and settings unique to the backend. ESourceExtension subclasses written for specific backends are generally not available to applications and shared libraries. This is by design, to try and keep backend-specific knowledge from creeping into places it doesn't belong.
As of 3.12, an ESource with an ESourceProxy extension can serve as a
g_proxy_resolver_is_supported()
g_proxy_resolver_is_supported()
FALSE
G_IO_ERROR_NOT_SUPPORTED
ESource * e_source_new (,
GDBusObject *dbus_object,
GMainContext *main_context);
GError **error
Creates a new ESource instance.
The main_context
if given,
or else from the thread-default
The only time the function should be called outside of ESourceRegistry is to create a so-called "scratch" ESource for editing in a Properties window or an account setup assistant.
FIXME: Elaborate on scratch sources.
dbus_object |
a |
[allow-none] |
main_context |
a |
[allow-none] |
error |
return location for a |
Since: 3.6
ESource * e_source_new_with_uid (const
,gchar *uid,
GMainContext *main_context);
GError **error
Creates a new "scratch" ESource with a predetermined unique identifier.
The main_context
if given,
or else from the thread-default
uid |
a new unique identifier string |
|
main_context |
a |
[allow-none] |
error |
return location for a |
Since: 3.6
guint e_source_hash (ESource *source
);
Generates a hash value for source
. This function is intended for
easily hashing an ESource to add to a
Since: 3.6
gboolean e_source_equal (ESource *source1
,ESource *source2
);
Checks two ESource instances for equality. ESource instances are equal if their unique identifier strings are equal.
Since: 3.6
void e_source_changed (ESource *source
);
Emits the source
's
This function is primarily intended for use by ESourceExtension
when emitting a
Since: 3.6
constgchar * e_source_get_uid (ESource *source
);
Returns the unique identifier string for source
.
Since: 3.6
gchar * e_source_dup_uid (ESource *source
);
Thread-safe variation of e_source_get_uid()
.
Use this function when accessing source
from multiple threads.
The returned string should be freed with g_free()
Since: 3.6
constgchar * e_source_get_parent (ESource *source
);
Returns the unique identifier string of the parent ESource.
Since: 3.6
gchar * e_source_dup_parent (ESource *source
);
Thread-safe variation of e_source_get_parent()
.
Use this function when accessing source
from multiple threads.
The returned string should be freed with g_free()
Since: 3.6
void e_source_set_parent (ESource *source
,const
);gchar *parent
Identifies the parent of source
by its unique identifier string.
This can only be set prior to adding source
to an ESourceRegistry.
The internal copy of NULL
Since: 3.6
gboolean e_source_get_enabled (ESource *source
);
Returns TRUE
source
is enabled.
An application should try to honor this setting if at all possible, even if it does not provide a way to change the setting through its user interface. Disabled data sources should generally be hidden.
This function does not take into account source
's ancestors in the
ESource hierarchy, each of which have their own enabled state. If
any of source
's ancestors are disabled, then source
itself should
be treated as disabled. Use e_source_registry_check_enabled()
to
easily check for this.
Since: 3.6
void e_source_set_enabled (ESource *source
,);
gboolean enabled
Enables or disables source
.
An application should try to honor this setting if at all possible, even if it does not provide a way to change the setting through its user interface. Disabled data sources should generally be hidden.
Since: 3.6
gboolean e_source_get_writable (ESource *source
);
Returns whether the D-Bus service will accept changes to source
.
If source
is not writable, calls to e_source_write()
will fail.
Since: 3.6
gboolean e_source_get_removable (ESource *source
);
Returns whether the D-Bus service will allow source
to be removed.
If source
is not writable, calls to e_source_remove()
will fail.
Since: 3.6
gboolean e_source_get_remote_creatable (ESource *source
);
Returns whether new resources can be created on a remote server by
calling e_source_remote_create()
on source
.
Generally this is only TRUE
source
has an ESourceCollection
extension, which means there is an ECollectionBackend in the D-Bus
service that can handle create requests. If source
does not have
this capability, calls to e_source_remote_create()
will fail.
Since: 3.6
gboolean e_source_get_remote_deletable (ESource *source
);
Returns whether the resource represented by source
can be deleted
from a remote server by calling e_source_remote_delete()
.
Generally this is only TRUE
source
is a child of an ESource
which has an ESourceCollection extension, which means there is an
ECollectionBackend in the D-Bus service that can handle delete
requests. If source
does not have this capability, calls to
e_source_remote_delete()
will fail.
Since: 3.6
gpointer e_source_get_extension (ESource *source
,const
);gchar *extension_name
Returns an instance of some ESourceExtension subclass which registered
itself under extension_name
. If no such instance exists within source
,
one will be created. It is the caller's responsibility to know which
subclass is being returned.
If you just want to test for the existence of an extension within source
without creating it, use e_source_has_extension()
.
Extension instances are owned by their ESource and should not be referenced directly. Instead, reference the ESource instance and use this function to fetch the extension instance as needed.
Since: 3.6
gboolean e_source_has_extension (ESource *source
,const
);gchar *extension_name
Checks whether source
has an ESourceExtension with the given name.
Since: 3.6
GDBusObject * e_source_ref_dbus_object (ESource *source
);
Returns the e_source_new()
.
The returned g_object_unref()
Since: 3.6
GMainContext * e_source_ref_main_context (ESource *source
);
Returns the source
are to
be attached.
The returned g_main_context_unref()
Since: 3.6
constgchar * e_source_get_display_name (ESource *source
);
Returns the display name for source
. Use the display name to
represent the ESource in a user interface.
Since: 3.6
gchar * e_source_dup_display_name (ESource *source
);
Thread-safe variation of e_source_get_display_name()
.
Use this function when accessing source
from multiple threads.
The returned string should be freed with g_free()
Since: 3.6
void e_source_set_display_name (ESource *source
,const
);gchar *display_name
Sets the display name for source
. The display_name
argument must be a
valid UTF-8 string. Use the display name to represent the ESource in a
user interface.
The internal copy of display_name
is automatically stripped of leading
and trailing whitespace.
Since: 3.6
gchar * e_source_dup_secret_label (ESource *source
);
Creates a label string based on source
's
Since: 3.12
gint e_source_compare_by_display_name (ESource *source1
,ESource *source2
);
Compares two ESource instances by their display names. Useful for ordering sources in a user interface.
a negative value if source1
compares before source2
, zero if
they compare equal, or a positive value if source1
compares
after source2
Since: 3.6
gchar * e_source_to_string (ESource *source
,);
gsize *length
Outputs the current contents of source
as a key file string.
Free the returned string with g_free()
source |
an ESource |
|
length |
return location for the length of the returned
string, or |
[allow-none] |
Since: 3.6
gchar * e_source_parameter_to_key (const
);gchar *param_name
Converts a
This function is made public only to aid in account migration. Applications should not need to use this.
Since: 3.6
ESourceConnectionStatus
e_source_get_connection_status (ESource *source
);
Obtain current connection status of the source
.
Since: 3.16
void e_source_set_connection_status (ESource *source
,ESourceConnectionStatus connection_status
);
Set's current connection status of the source
.
Since: 3.16
gboolean e_source_remove_sync (ESource *source
,,
GCancellable *cancellable);
GError **error
Requests the D-Bus service to delete the key files for source
and all of
its descendants and broadcast their removal to all clients. The source
must be
If an error occurs, the functon will set error
and return FALSE
source |
the ESource to be removed |
|
cancellable |
optional |
[allow-none] |
error |
return location for a |
Since: 3.6
void e_source_remove (ESource *source
,,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Asynchronously requests the D-Bus service to delete the key files for
source
and all of its descendants and broadcast their removal to all
clients. The source
must be
When the operation is finished, callback
will be called. You can then
call e_source_remove_finish()
to get the result of the operation.
source |
the ESource to be removed |
|
cancellable |
optional |
[allow-none] |
callback |
a |
[scope async] |
user_data |
data to pass to the callback function. |
[closure] |
Since: 3.6
gboolean e_source_remove_finish (ESource *source
,,
GAsyncResult *result);
GError **error
Finishes the operation started with e_source_remove()
. If an
error occurred, the function will set error
and return FALSE
source |
the ESource to be removed |
|
result |
a |
|
error |
return location for a |
Since: 3.6
gboolean e_source_write_sync (ESource *source
,,
GCancellable *cancellable);
GError **error
Submits the current contents of source
to the D-Bus service to be
written to disk and broadcast to other clients. The source
must
be
If an error occurs, the functon will set error
and return FALSE
source |
a writable ESource |
|
cancellable |
optional |
[allow-none] |
error |
return location for a |
Since: 3.6
void e_source_write (ESource *source
,,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Asynchronously submits the current contents of source
to the D-Bus
service to be written to disk and broadcast to other clients. The
source
must be
When the operation is finished, callback
will be called. You can then
call e_source_write_finish()
to get the result of the operation.
source |
a writable ESource |
|
cancellable |
optional |
[allow-none] |
callback |
a |
[scope async] |
user_data |
data to pass to the callback function. |
[closure] |
Since: 3.6
gboolean e_source_write_finish (ESource *source
,,
GAsyncResult *result);
GError **error
Finishes the operation started with e_source_write()
. If an
error occurred, the function will set error
and return FALSE
source |
a writable ESource |
|
result |
a |
|
error |
return location for a |
Since: 3.6
gboolean e_source_remote_create_sync (ESource *source
,ESource *scratch_source
,,
GCancellable *cancellable);
GError **error
Creates a new remote resource by picking out relevant details from
scratch_source
. The scratch_source
must be an ESource with no
source
must be
The details required to create the resource vary by ECollectionBackend,
but in most cases the scratch_source
need only define the resource type
(address book, calendar, etc.), a display name for the resource, and
possibly a server-side path or ID for the resource.
If an error occurs, the function will set error
and return FALSE
Since: 3.6
void e_source_remote_create (ESource *source
,ESource *scratch_source
,,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Asynchronously creates a new remote resource by picking out relevant
details from scratch_source
. The scratch_source
must be an ESource
with no source
must be
The details required to create the resource vary by ECollectionBackend,
but in most cases the scratch_source
need only define the resource type
(address book, calendar, etc.), a display name for the resource, and
possibly a server-side path or ID for the resource.
When the operation is finished, callback
will be called. You can then
call e_source_remote_create_finish()
to get the result of the operation.
Since: 3.6
gboolean e_source_remote_create_finish (ESource *source
,,
GAsyncResult *result);
GError **error
Finishes the operation started with e_source_remote_create()
. If
an error occurred, the function will set error
and return FALSE
Since: 3.6
gboolean e_source_remote_delete_sync (ESource *source
,,
GCancellable *cancellable);
GError **error
Deletes the resource represented by source
from a remote server.
The source
must be source
and broadcast its removal to all clients,
similar to e_source_remove_sync()
.
If an error occurs, the function will set error
and return FALSE
source |
an ESource |
|
cancellable |
optional |
[allow-none] |
error |
return location for a |
Since: 3.6
void e_source_remote_delete (ESource *source
,,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Asynchronously deletes the resource represented by source
from a remote
server. The source
must be source
and broadcast its removal to all clients,
similar to e_source_remove()
.
When the operation is finished, callback
will be called. You can then
call e_source_remote_delete_finish()
to get the result of the operation.
source |
an ESource |
|
cancellable |
optional |
[allow-none] |
callback |
a |
[scope async] |
user_data |
data to pass to the callback function. |
[closure] |
Since: 3.6
gboolean e_source_remote_delete_finish (ESource *source
,,
GAsyncResult *result);
GError **error
Finishes the operation started with e_source_remote_delete()
. If
an error occurred, the function will set error
and return FALSE
Since: 3.6
gboolean e_source_get_oauth2_access_token_sync (ESource *source
,,
GCancellable *cancellable,
gchar **out_access_token,
gint *out_expires_in);
GError **error
Obtains the OAuth 2.0 access token for source
along with its expiry
in seconds from the current time (or 0 if unknown).
Free the returned access token with g_free()
error
and return FALSE
source |
an ESource |
|
cancellable |
optional |
[allow-none] |
out_access_token |
return location for the access token,
or |
[allow-none][out] |
out_expires_in |
return location for the token expiry,
or |
[allow-none][out] |
error |
return location for a |
Since: 3.8
void e_source_get_oauth2_access_token (ESource *source
,,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Asynchronously obtains the OAuth 2.0 access token for source
along
with its expiry in seconds from the current time (or 0 if unknown).
When the operation is finished, callback
will be called. You can then
call e_source_get_oauth2_access_token_finish()
to get the result of the
operation.
source |
an ESource |
|
cancellable |
optional |
[allow-none] |
callback |
a |
[scope async] |
user_data |
data to pass to the callback function. |
[closure] |
Since: 3.8
gboolean e_source_get_oauth2_access_token_finish (ESource *source
,,
GAsyncResult *result,
gchar **out_access_token,
gint *out_expires_in);
GError **error
Finishes the operation started with e_source_get_oauth2_access_token()
.
Free the returned access token with g_free()
error
and return FALSE
source |
an ESource |
|
result |
a |
|
out_access_token |
return location for the access token,
or |
[allow-none][out] |
out_expires_in |
return location for the token expiry,
or |
[allow-none][out] |
error |
return location for a |
Since: 3.8
gboolean e_source_store_password_sync (ESource *source
,const
,gchar *password,
gboolean permanently,
GCancellable *cancellable);
GError **error
Stores a password for source
. This operation does not rely on the
registry service and therefore works for any ESource -- registered
or "scratch".
If permanently
is TRUE
error
and returns FALSE
source |
an ESource |
|
password |
the password to store |
|
permanently |
store permanently or just for the session |
|
cancellable |
optional |
|
error |
return location for a |
Since: 3.12
void e_source_store_password (ESource *source
,const
,gchar *password,
gboolean permanently,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Asynchronously stores a password for source
. This operation does
not rely on the registry service and therefore works for any ESource
-- registered or "scratch".
If permanently
is TRUE
error
and returns FALSE
When the operation is finished, callback
will be called. You can then
call e_source_store_password_finish()
to get the result of the operation.
source |
an ESource |
|
password |
the password to store |
|
permanently |
store permanently or just for the session |
|
cancellable |
optional |
|
callback |
a |
|
user_data |
data to pass to the callback function |
Since: 3.12
gboolean e_source_store_password_finish (ESource *source
,,
GAsyncResult *result);
GError **error
Finishes the operation started with e_source_store_password()
.
Since: 3.12
gboolean e_source_lookup_password_sync (ESource *source
,,
GCancellable *cancellable,
gchar **out_password);
GError **error
Looks up a password for source
. Both the default and session keyrings
are queried. This operation does not rely on the registry service and
therefore works for any ESource -- registered or "scratch".
Note the boolean return value indicates whether the lookup operation
itself completed successfully, not whether a password was found. If
no password was found, the function will set out_password
to NULL
TRUE
error
and returns FALSE
source |
an ESource |
|
cancellable |
optional |
|
out_password |
return location for the password, or |
[out] |
error |
return location for a |
Since: 3.12
void e_source_lookup_password (ESource *source
,,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Asynchronously looks up a password for source
. Both the default and
session keyrings are queried. This operation does not rely on the
registry service and therefore works for any ESource -- registered
or "scratch".
When the operation is finished, callback
will be called. You can then
call e_source_lookup_password_finish()
to get the result of the operation.
source |
an ESource |
|
cancellable |
optional |
|
callback |
a |
|
user_data |
data to pass to the callback function |
Since: 3.12
gboolean e_source_lookup_password_finish (ESource *source
,,
GAsyncResult *result,
gchar **out_password);
GError **error
Finishes the operation started with e_source_lookup_password()
.
Note the boolean return value indicates whether the lookup operation
itself completed successfully, not whether a password was found. If
no password was found, the function will set out_password
to NULL
TRUE
error
and returns FALSE
source |
an ESource |
|
result |
a |
|
out_password |
return location for the password, or |
[out] |
error |
return location for a |
Since: 3.12
gboolean e_source_delete_password_sync (ESource *source
,,
GCancellable *cancellable);
GError **error
Deletes the password for source
from either the default keyring or
session keyring. This operation does not rely on the registry service
and therefore works for any ESource -- registered or "scratch".
Note the boolean return value indicates whether the delete operation
itself completed successfully, not whether a password was found and
deleted. If no password was found, the function will still return
TRUE
error
and returns FALSE
source |
an ESource |
|
cancellable |
optional |
|
error |
return location for a |
Since: 3.12
void e_source_delete_password (ESource *source
,,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Asynchronously deletes the password for source
from either the default
keyring or session keyring. This operation does not rely on the registry
service and therefore works for any ESource -- registered or "scratch".
When the operation is finished, callback
will be called. You can then
call e_source_delete_password_finish()
to get the result of the operation.
source |
an ESource |
|
cancellable |
optional |
|
callback |
a |
|
user_data |
data to pass to the callback function |
Since: 3.12
gboolean e_source_delete_password_finish (ESource *source
,,
GAsyncResult *result);
GError **error
Finishes the operation started with e_source_delete_password()
.
Note the boolean return value indicates whether the delete operation
itself completed successfully, not whether a password was found and
deleted. If no password was found, the function will still return
TRUE
error
and returns FALSE
Since: 3.12
gboolean e_source_invoke_credentials_required_sync (ESource *source
,ESourceCredentialsReason reason
,const
,gchar *certificate_pem,
GTlsCertificateFlags certificate_errorsconst
,GError *op_error,
GCancellable *cancellable);
GError **error
Let's the client-side know that credentials are required. The reason
defines which
parameters are used. The client passed the credentials with an e_source_authenitcate()
The E_SOURCE_CREDENTIALS_REASON_REQUIRED
is used for the first credentials prompt,
when the client can return credentials as stored from the previous success login.
The E_SOURCE_CREDENTIALS_REASON_REJECTED
is used when the previously used credentials
had been rejected by the server. That usually means that the user should be asked
to provide/correct the credentials.
The E_SOURCE_CREDENTIALS_REASON_SSL_FAILED
is used when a secured connection failed
due to some server-side certificate issues.
The E_SOURCE_CREDENTIALS_REASON_ERROR
is used when the server returned an error.
It is not possible to connect to it at the moment usually.
If an error occurs, the function sets error
and returns FALSE
source |
an ESource |
|
reason |
an ESourceCredentialsReason, why the credentials are required |
|
certificate_pem |
PEM-encoded secure connection certificate, or an empty string |
|
certificate_errors |
a bit-or of |
|
op_error |
a |
[allow-none] |
cancellable |
optional |
[allow-none] |
error |
return location for a |
[allow-none] |
Since: 3.16
void e_source_invoke_credentials_required (ESource *source
,ESourceCredentialsReason reason
,const
,gchar *certificate_pem,
GTlsCertificateFlags certificate_errorsconst
,GError *op_error,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Asynchronously calls the InvokeCredentialsRequired method on the server side, to inform clients that credentials are required.
When the operation is finished, callback
will be called. You can then
call e_source_invoke_credentials_required_finish()
to get the result of the operation.
source |
an ESource |
|
reason |
an ESourceCredentialsReason, why the credentials are required |
|
certificate_pem |
PEM-encoded secure connection certificate, or an empty string |
|
certificate_errors |
a bit-or of |
|
op_error |
a |
[allow-none] |
cancellable |
optional |
[allow-none] |
callback |
a |
|
user_data |
data to pass to the callback function |
Since: 3.16
gboolean e_source_invoke_credentials_required_finish (ESource *source
,,
GAsyncResult *result);
GError **error
Finishes the operation started with e_source_invoke_credentials_required()
.
If an error occurs, the function sets error
and returns FALSE
source |
an ESource |
|
result |
a |
|
error |
return location for a |
[allow-none] |
Since: 3.16
gboolean e_source_invoke_authenticate_sync (ESource *source
,const ENamedParameters *credentials
,,
GCancellable *cancellable);
GError **error
Calls the InvokeAuthenticate method on the server side, thus the backend knows what credentials to use to connect to its (possibly remote) data store.
If an error occurs, the function sets error
and returns FALSE
source |
an ESource |
|
credentials |
an ENamedParameters structure with credentials to use; can be |
[allow-none] |
cancellable |
optional |
[allow-none] |
error |
return location for a |
[allow-none] |
Since: 3.16
void e_source_invoke_authenticate (ESource *source
,const ENamedParameters *credentials
,,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Asynchronously calls the InvokeAuthenticate method on the server side, thus the backend knows what credentials to use to connect to its (possibly remote) data store.
When the operation is finished, callback
will be called. You can then
call e_source_invoke_authenticate_finish()
to get the result of the operation.
source |
an ESource |
|
credentials |
an ENamedParameters structure with credentials to use; can be |
[allow-none] |
cancellable |
optional |
[allow-none] |
callback |
a |
|
user_data |
data to pass to the callback function |
Since: 3.16
gboolean e_source_invoke_authenticate_finish (ESource *source
,,
GAsyncResult *result);
GError **error
Finishes the operation started with e_source_invoke_authenticate()
.
If an error occurs, the function sets error
and returns FALSE
source |
an ESource |
|
result |
a |
|
error |
return location for a |
[allow-none] |
Since: 3.16
void e_source_emit_credentials_required (ESource *source
,ESourceCredentialsReason reason
,const
,gchar *certificate_pem,
GTlsCertificateFlags certificate_errorsconst
);GError *op_error
Emits localy (in this process only) the ESource::credentials-required
signal with given parameters. That's the difference with e_source_invoke_credentials_required()
,
which calls the signal globally, within each client.
source |
an ESource |
|
reason |
an ESourceCredentialsReason, why the credentials are required |
|
certificate_pem |
PEM-encoded secure connection certificate, or an empty string |
|
certificate_errors |
a bit-or of |
|
op_error |
a |
[allow-none] |
Since: 3.16
gboolean e_source_get_last_credentials_required_arguments_sync (ESource *source
,ESourceCredentialsReason *out_reason
,,
gchar **out_certificate_pem,
GTlsCertificateFlags *out_certificate_errors,
GError **out_op_error,
GCancellable *cancellable);
GError **error
Retrieves the last used arguments of the 'credentials-required' signal emission.
If there was none emitted yet, or a corresponding 'authenitcate' had been emitted
already, then the out_reason
is set to E_SOURCE_CREDENTIALS_REASON_UNKNOWN
and the value of other 'out' arguments is set to no values.
If an error occurs, the function sets error
and returns FALSE
g_free()
source |
an ESource |
|
out_reason |
an ESourceCredentialsReason, why the credentials are required. |
[out] |
out_certificate_pem |
PEM-encoded secure connection certificate, or an empty string. |
[out] |
out_certificate_errors |
a bit-or of |
[out] |
out_op_error |
a |
[out] |
cancellable |
optional |
[allow-none] |
error |
return location for a |
[allow-none] |
Since: 3.16
void e_source_get_last_credentials_required_arguments (ESource *source
,,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Asynchronously calls the GetLastCredentialsRequiredArguments method
on the server side, to get the last values used for the 'credentials-required'
signal. See e_source_get_last_credentials_required_arguments_sync()
for
more information.
When the operation is finished, callback
will be called. You can then
call e_source_get_last_credentials_required_arguments_finish()
to get
the result of the operation.
source |
an ESource |
|
cancellable |
optional |
[allow-none] |
callback |
a |
|
user_data |
data to pass to the callback function |
Since: 3.16
gboolean e_source_get_last_credentials_required_arguments_finish (ESource *source
,,
GAsyncResult *resultESourceCredentialsReason *out_reason
,,
gchar **out_certificate_pem,
GTlsCertificateFlags *out_certificate_errors,
GError **out_op_error);
GError **error
Finishes the operation started with e_source_get_last_credentials_required_arguments()
.
See e_source_get_last_credentials_required_arguments_sync()
for more information
about the output arguments.
If an error occurs, the function sets error
and returns FALSE
source |
an ESource |
|
result |
a |
|
out_reason |
an ESourceCredentialsReason, why the credentials are required. |
[out] |
out_certificate_pem |
PEM-encoded secure connection certificate, or an empty string. |
[out] |
out_certificate_errors |
a bit-or of |
[out] |
out_op_error |
a |
[out] |
error |
return location for a |
[allow-none] |
Since: 3.16
gboolean e_source_unset_last_credentials_required_arguments_sync (ESource *source
,,
GCancellable *cancellable);
GError **error
Unsets the last used arguments of the 'credentials-required' signal emission.
If an error occurs, the function sets error
and returns FALSE
source |
an ESource |
|
cancellable |
optional |
[allow-none] |
error |
return location for a |
[allow-none] |
Since: 3.18
void e_source_unset_last_credentials_required_arguments (ESource *source
,,
GCancellable *cancellable,
GAsyncReadyCallback callback);
gpointer user_data
Asynchronously calls the UnsetLastCredentialsRequiredArguments method on the server side, to unset the last values used for the 'credentials-required' signal.
When the operation is finished, callback
will be called. You can then
call e_source_unset_last_credentials_required_arguments_finish()
to get
the result of the operation.
source |
an ESource |
|
cancellable |
optional |
[allow-none] |
callback |
a |
|
user_data |
data to pass to the callback function |
Since: 3.18
gboolean e_source_unset_last_credentials_required_arguments_finish (ESource *source
,,
GAsyncResult *result);
GError **error
Finishes the operation started with e_source_unset_last_credentials_required_arguments()
.
If an error occurs, the function sets error
and returns FALSE
source |
an ESource |
|
result |
a |
|
error |
return location for a |
[allow-none] |
Since: 3.18
#define E_SOURCE_PARAM_SETTING (1 << G_PARAM_USER_SHIFT)
Extends
Since: 3.6
#define E_SOURCE_CREDENTIAL_USERNAME "username"
A name of the named parameter used for usernames in credentials,
used to authenticate users with e_source_invoke_authenticate_sync()
and e_source_invoke_authenticate()
. The named parameter is optional,
different authentication methods can use different names.
Since: 3.16
#define E_SOURCE_CREDENTIAL_PASSWORD "password"
A name of the named parameter used for passwords in credentials,
used to authenticate users with e_source_invoke_authenticate_sync()
and e_source_invoke_authenticate()
. The named parameter is optional,
different authentication methods can use different names.
Since: 3.16
#define E_SOURCE_CREDENTIAL_SSL_TRUST "ssl-trust"
A name of the named parameter used for SSL/TLS trust in credentials,
used to authenticate users with e_source_invoke_authenticate_sync()
and e_source_invoke_authenticate()
. The named parameter is optional.
Its value corresponds to current ESourceWebdav::ssl-trust property,
in case the ESource has that extension available. This is required
to have up-to-date data on the server side, when the client side
just saved the SSL trust change, which might not be propagated
into the server (factory) side quickly enough. The key is added into
the credentials in invoke_authneticate()
Since: 3.16
struct ESource { };
Contains only private data that should be read and manipulated using the functions below.
Since: 3.6