Function
EDataServerUItrust_prompt_run_modal
since: 3.16
Declaration [src]
ETrustPromptResponse
e_trust_prompt_run_modal (
GtkWindow* parent,
const gchar* source_extension,
const gchar* source_display_name,
const gchar* host,
const gchar* certificate_pem,
GTlsCertificateFlags certificate_errors,
const gchar* error_text
)
Description [src]
Runs modal (doesn’t return until the dialog is closed) a trust prompt dialog,
it is a prompt whether a user wants to accept or reject the certificate_pem
for the host due to the certificate_errors errors.
The pair source_extension and source_display_name influences the trust prompt message.
If both are set, then the message also contains which source failed to connect according
to these two arguments.
The dialog can contain a custom error text, passed in as error_text.
The error might be a detailed error string returned by the server. If set,
it is prefixed with “Detailed error:” string.
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_extension-
Type:
const gchar*An
ESourceextension, to identify a kind of the source; orNULL.The argument can be NULL.The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. source_display_name-
Type:
const gchar*An
ESourcedisplay name, to identify what prompts; orNULL.The argument can be NULL.The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. host-
Type:
const gchar*A host name to which the certificate belongs.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. 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.
Return value
Type: ETrustPromptResponse
A code of the user’s choice. The #E_TRUST_PROMPT_RESPONSE_UNKNOWN is returned, when the user cancelled the trust prompt dialog.