Gio.TlsInteraction::request_certificate
function vfunc_request_certificate(connection: Gio.TlsConnection, flags: Gio.TlsCertificateRequestFlags, cancellable: Gio.Cancellable): Gio.TlsInteractionResult { }
Run synchronous interaction to ask the user to choose a certificate to use with the connection. In general, Gio.TlsInteraction.prototype.invoke_request_certificate 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 Gio.TlsInteractionResult.handled is returned, then the Gio.TlsConnection passed to Gio.TlsInteraction.prototype.request_certificate will have had its Gio.TlsConnection.certificate filled in.
If the interaction is cancelled by the cancellation object, or by the user then Gio.TlsInteractionResult.failed will be returned with an error that contains a Gio.IOErrorEnum.cancelled error code. Certain implementations may not support immediate cancellation.
Since 2.40
- connection
a Gio.TlsConnection object
- flags
flags providing more information about the request
- cancellable
an optional Gio.Cancellable cancellation object
- Returns
The status of the request certificate interaction.