request_certificate

Run synchronous interaction to ask the user to choose a certificate to use with the connection.

In general, 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 TlsConnection passed to request_certificate 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:

this	a TlsInteraction object
connection	a TlsConnection object
flags	flags providing more information about the request
cancellable	an optional Cancellable cancellation object

Returns:

The status of the request certificate interaction.