TlsInteraction.requestCertificate

Run synchronous interaction to ask the user to choose a certificate to use with the connection. In general, g_tls_interaction_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 %G_TLS_INTERACTION_HANDLED is returned, then the #GTlsConnection passed to g_tls_interaction_request_certificate() will have had its #GTlsConnection: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

a #GTlsConnection object

flags GTlsCertificateRequestFlags

flags providing more information about the request

cancellable Cancellable

an optional #GCancellable cancellation object

Return Value

The status of the request certificate interaction.

Throws

GException on failure.

Meta

Since

2.40