Virtual Method

GioTlsInteractionrequest_certificate

since: 2.40

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

Type: GTlsConnection

A GTlsConnection object.

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

Type: GTlsCertificateRequestFlags

Flags providing more information about the request.

cancellable

Type: GCancellable

An optional GCancellable cancellation object.

The argument can be NULL.
The data is owned by the caller of the function.
error

Type: GError **

The return location for a recoverable error.

The argument can be NULL.
If the return location is not NULL, then you must initialize it to a NULL GError*.
The argument will left initialized to NULL by the virtual function if there are no errors.
In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.

Return value

Type: GTlsInteractionResult

The status of the request certificate interaction.