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.