Function
EDataServerUItrust_prompt_run_for_source
since: 3.16
Declaration [src]
void
e_trust_prompt_run_for_source (
GtkWindow* parent,
ESource* source,
const gchar* certificate_pem,
GTlsCertificateFlags certificate_errors,
const gchar* error_text,
gboolean allow_source_save,
GCancellable* cancellable,
GAsyncReadyCallback callback,
gpointer user_data
)
Description [src]
Similar to e_trust_prompt_run_modal(), except it also manages all the necessary things
around the source‘s SSL/TLS trust properties when it also contains E_SOURCE_EXTENSION_WEBDAV,
thus the SSL/TLS trust on the WebDAV source is properly updated based on the user’s choice.
The call is finished with e_trust_prompt_run_for_source_finish(),
which also returns the user’s choice. The finish happens in the callback.
This is necessary, because the source can be also saved.
The function fails, if the source doesn’t contain the E_SOURCE_EXTENSION_AUTHENTICATION.
Note: The dialog is not shown when the stored certificate trust in the WebDAV source
matches the certificate_pem and the stored result is #E_TRUST_PROMPT_RESPONSE_REJECT.
Available since: 3.16
Parameters
parent-
Type:
GtkWindowA
GtkWindowto use as a parent for the trust prompt dialog.The data is owned by the caller of the function. source-
Type:
ESourceAn
ESource, withE_SOURCE_EXTENSION_AUTHENTICATION.The data is owned by the caller of the function. certificate_pem-
Type:
const gchar*A PEM-encoded certificate for which to show the trust prompt.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. certificate_errors-
Type:
GTlsCertificateFlagsErrors of the
certificate_pem. error_text-
Type:
const gchar*An optional error text to show in the dialog; can be
NULL.The argument can be NULL.The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. allow_source_save-
Type:
gbooleanWhether can also save any
sourcechanges. cancellable-
Type:
GCancellableA
GCancellable, orNULL.The argument can be NULL.The data is owned by the caller of the function. callback-
Type:
GAsyncReadyCallbackA callback to call, when the prompt (an
sourcesave) is done.The argument can be NULL. user_data-
Type:
gpointerUser data passed into
callback.The argument can be NULL.The data is owned by the caller of the function.