方法
GioDtlsConnectionget_channel_binding_data
since: 2.66
声明 [src]
gboolean
g_dtls_connection_get_channel_binding_data (
GDtlsConnection* conn,
GTlsChannelBindingType type,
GByteArray* data,
GError** error
)
描述 [src]
查询对于conn
连接的type
类型的TLS通道绑定数据。
该调用根据RFC 5056、5929和相关RFC指定检索TLS通道绑定数据。绑定数据存储在data
中。由调用者使用GByteArray
缓冲区管理来调整data
的大小,并在data
通过g_byte_array_unref()销毁时释放。如果data
为NULL
,则仅检查TLS后端是否能够获取数据(例如,是否由TLS后端支持type
)。但并不保证数据的可获取性。如果TLS连接不支持type
或通道绑定数据因附加协商或输入需求还未可用,则可能会发生这种情况。
自2.66起可用
参数
type
-
GTlsChannelBindingType
要获取的数据类型。 data
-
类型:
guint8
数组GByteArray
将填充绑定数据,或NULL
。该参数将由函数设置。 该参数可以为 NULL
。返回的数据由实例拥有。 error
-
类型:
GError **
一个可恢复错误的返回位置。
该参数可以为 NULL
。如果返回位置不为 NULL
,则必须将其初始化为NULL
的GError*
。如果没有错误,方法将保留初始为 NULL
的参数。如果发生错误,参数将设置为一个新的分配的 GError
;调用者将拥有数据,并负责释放它。