TlsInteraction.requestCertificate

Run synchronous interaction to ask the user to choose a certificate to use with the connection. In general, TlsInteraction.invokeRequestCertificate should be used instead of this function.

Derived subclasses usually implement a certificate selector, although they may also choose to provide a certificate from elsewhere. Alternatively the user may abort this certificate request, which will usually abort the TLS connection.

If G_TLS_INTERACTION_HANDLED is returned, then the gio.TlsConnection passed to TlsInteraction.requestCertificate will have had its certificate filled in.

If the interaction is cancelled by the cancellation object, or by the user then G_TLS_INTERACTION_FAILED will be returned with an error that contains a G_IO_ERROR_CANCELLED error code. Certain implementations may not support immediate cancellation.

Parameters

connection TlsConnection
flags GTlsCertificateRequestFlags

flags providing more information about the request

cancellable Cancellable

an optional gio.Cancellable cancellation object

Return Value

The status of the request certificate interaction.

Throws

GException on failure.

Meta

Since

2.40