接口

GioTlsClientConnection

since: 2.28

描述 [src]

interface Gio.TlsClientConnection : Gio.TlsConnection

GTlsClientConnectionGTlsConnection 的客户端子类,表示客户端 TLS 连接。

自版本 2.28 起可用

前提条件

为实现 TlsClientConnection,您的类型必须继承自GTlsConnection

函数

g_tls_client_connection_new

创建一个新的 GTlsClientConnection,封装 base_io_stream(该流必须有可轮询输入和输出流),并假定与 server_identity 标识的服务器进行通信。

since: 2.28

实例方法

g_tls_client_connection_copy_session_state

可能将会话状态从一个连接复制到另一个连接,以便在 TLS 会话恢复中使用。这通常不需要,但可能在需要同一会话在不同端点之间使用时使用,正如某些协议所需要的,例如 FTP over TLS

since: 2.46

g_tls_client_connection_get_accepted_cas

获取服务器将接受证书的证书颁发机构的识别名称列表。如果服务器请求证书,这将在 TLS 握手期间设置。否则,它将为 NULL

since: 2.28

g_tls_client_connection_get_server_identity

获取 conn 预期的服务器身份。

since: 2.28

g_tls_client_connection_get_use_ssl3

SSL 3.0 不再支持。有关详细信息,请参阅 g_tls_client_connection_set_use_ssl3()

已弃用: 2.56 since: 2.28

g_tls_client_connection_get_validation_flags

获取 conn 验证标志。

已弃用: 2.72 since: 2.28

g_tls_client_connection_set_server_identity

设置 conn 的预期服务器标识,这用于告知虚拟主机上的服务器出示哪个证书,并还让 conn 了解在执行 G_TLS_CERTIFICATE_BAD_IDENTITY 验证时在证书中查找什么名称(如果已启用)。

since: 2.28

g_tls_client_connection_set_use_ssl3

自 GLib 2.42.1 起,SSL 3.0 不再支持。

已弃用: 2.56 since: 2.28

g_tls_client_connection_set_validation_flags

设置 conn 的验证标志,来覆盖验证服务器证书时执行的默认检查集。默认情况下,使用 G_TLS_CERTIFICATE_VALIDATE_ALL

已弃用: 2.72 since: 2.28

属性

Gio.TlsClientConnection:accepted-cas

服务器将接受其签名的客户端证书的认证机构专有名称列表。如果在握手期间服务器请求客户端证书,则此属性将在握手完成后设置。

since: 2.28

Gio.TlsClientConnection:server-identity

一个 GSocketConnectable,描述连接另一端的服务器身份。

since: 2.28

Gio.TlsClientConnection:use-ssl3

SSL 3.0 不再支持。有关详细信息,请参阅 g_tls_client_connection_set_use_ssl3()

已弃用: 2.56 since: 2.28

Gio.TlsClientConnection:validation-flags

验证从服务器接收的证书时执行的步骤。未能通过此规则验证的服务器证书将被拒绝,除非应用程序通过 GTlsConnection::accept-certificate 覆盖默认值。

已弃用: 2.72 since: 2.28

接口结构

struct GioTlsClientConnectionInterface {
  GTypeInterface g_iface;
  void (* copy_session_state) (
    GTlsClientConnection* conn,
    GTlsClientConnection* source
  );
  
}

GTlsClientConnection 实现的虚表。

接口成员
g_iface
GTypeInterface
 

父接口。

copy_session_state
void (* copy_session_state) (
    GTlsClientConnection* conn,
    GTlsClientConnection* source
  )
 

从一个 GTlsClientConnection 复制会话状态到另一个 GTlsClientConnection

虚拟方法

Gio.TlsClientConnection.copy_session_state

可能将会话状态从一个连接复制到另一个连接,以便在 TLS 会话恢复中使用。这通常不需要,但可能在需要同一会话在不同端点之间使用时使用,正如某些协议所需要的,例如 FTP over TLS

since: 2.46