Method

GioDtlsConnectionget_channel_binding_data

Declaration

gboolean
g_dtls_connection_get_channel_binding_data (
  GDtlsConnection* conn,
  GTlsChannelBindingType type,
  GByteArray* data,
  GError** error
)

Description

Query the TLS backend for TLS channel binding data of type for conn.

This call retrieves TLS channel binding data as specified in RFC 5056, RFC 5929, and related RFCs. The binding data is returned in data. The data is resized by the callee using GByteArray buffer management and will be freed when the data is destroyed by g_byte_array_unref(). If data is NULL, it will only check whether TLS backend is able to fetch the data (e.g. whether type is supported by the TLS backend). It does not guarantee that the data will be available though. That could happen if TLS connection does not support type or the binding data is not available yet due to additional negotiation or input required.

Available since:2.66

Parameters

type GTlsChannelBindingType
 

GTlsChannelBindingType type of data to fetch.

data An array of guint8
 

GByteArray is filled with the binding data, or NULL.

 The argument will be set by the function.
 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: gboolean
 

TRUE on success, FALSE otherwise.