trust_prompt_run_modal

Description:

[ Version ( since = "3.16" ) ]
public TrustPromptResponse trust_prompt_run_modal (Window parent, string? source_extension, string? source_display_name, string host, string certificate_pem, TlsCertificateFlags certificate_errors, string? error_text)

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.

Parameters:

parent	A Window to use as a parent for the trust prompt dialog
source_extension	an Source extension, to identify a kind of the source; or null
source_display_name	an Source display name, to identify what prompts; or null
host	a host name to which the certificate belongs
certificate_pem	a PEM-encoded certificate for which to show the trust prompt
certificate_errors	errors of the `certificate_pem`
error_text	an optional error text to show in the dialog; can be null

Returns:

A code of the user's choice. The UNKNOWN is returned, when the user cancelled the trust prompt dialog.

Namespace: E

Package: libedataserverui-1.2