Virtual Method

GioTlsInteractionrequest_certificate

Declaration

GTlsInteractionResult
request_certificate (
  GTlsInteraction* interaction,
  GTlsConnection* connection,
  GTlsCertificateRequestFlags flags,
  GCancellable* cancellable,
  GError** error
)

Description

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.

Available since:2.40

Parameters

connection GTlsConnection
 

A GTlsConnection object.

 The data is owned by the caller of the function.
flags GTlsCertificateRequestFlags
 

Flags providing more information about the request.

cancellable GCancellable
 

An optional GCancellable cancellation object.

 The argument can be NULL.
 The data is owned by the caller of the function.
error GError **
  The return location for a GError*, or NULL.

Return value

Returns: GTlsInteractionResult
 

The status of the request certificate interaction.