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:
GTlsConnectionA
GTlsConnectionobject.The data is owned by the caller of the method. flags-
Type:
GTlsCertificateRequestFlagsFlags providing more information about the request.
cancellable-
Type:
GCancellableAn optional
GCancellablecancellation object.The argument can be NULL.The data is owned by the caller of the method. 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 aNULLGError*.The argument will be left initialized to NULLby 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.