方法

GioTlsConnectionget_channel_binding_data

自2.66版起可用

声明 [源]

gboolean
g_tls_connection_get_channel_binding_data (
  GTlsConnection* conn,
  GTlsChannelBindingType type,
  GByteArray* data,
  GError** error
)

描述 [源]

查询为 conn 的 type 类型的 TLS 通道绑定数据。

此调用检索 TLS 通道绑定数据,如 RFC 5056、RFC 5929 和相关 RFC 中指定。绑定数据存储在 data 中。data 通过 g_byte_array_unref() 释放时由调用者使用 GByteArray 缓冲区管理进行缩放。如果 data 为 NULL,则仅检查 TLS 后端是否能够获取数据(例如,type 是否由 TLS 后端支持)。虽然不保证数据可用,但仍有可能。如果 TLS 连接不支持 type 或由于额外协商或需要输入,绑定数据尚不可用。

自 2.66 版起可用

参数

type

类型: GTlsChannelBindingType

GTlsChannelBindingType 要获取的数据类型。

data

类型: 一个 uint8 数组

GByteArray 用绑定数据填充,或 NULL

该参数将由函数设置。
该参数可以是 NULL
返回的数据属于该实例。
错误

类型: GError **

可恢复错误的返回位置。

该参数可以是 NULL
如果返回位置不是NULL,那么您必须将其初始化为NULLGError*
如果没有错误,该方法将把参数初始化为NULL
在出现错误的情况下,参数将被设置为一个新的GError分配;调用者将获取对数据的所有权,并负责释放它。

返回值

类型: gboolean

成功返回TRUE,否则返回FALSE