虚拟方法

GioTlsInteractionrequest_certificate

自 2.40

声明 [来源]

GTlsInteractionResult
request_certificate (
  GTlsInteraction* interaction,
  GTlsConnection* connection,
  GTlsCertificateRequestFlags flags,
  GCancellable* cancellable,
  GError** error
)

描述 [来源]

运行同步交互,提示用户选择与连接一起使用的证书。通常应使用 g_tls_interaction_invoke_request_certificate() 而不是此函数。

派生子类通常实现证书选择器,尽管它们也可以选择从其他位置提供证书。或者用户可以取消此证书请求,这通常会终止 TLS 连接。

如果返回 G_TLS_INTERACTION_HANDLED,则传递给 g_tls_interaction_request_certificate()GTlsConnection 将填充其 GTlsConnection:certificate

如果交互操作被取消对象或用户取消,则返回 G_TLS_INTERACTION_FAILED,其中包含包含 G_IO_ERROR_CANCELLED 错误代码的错误。某些实现可能不支持即时取消。

自 2.40 起可用

参数

connection

类型: GTlsConnection

GTlsConnection 对象。

数据由方法调用者拥有。
flags

类型: GTlsCertificateRequestFlags

提供有关请求更多信息的标志。

cancellable

类型: GCancellable

一个可选的 GCancellable 取消对象。

该参数可以是 NULL
数据由方法调用者拥有。
error

类型: GError **

恢复错误的位置。

该参数可以是 NULL
如果返回位置不是 NULL,那么您必须将其初始化为空的 GError*
如果没有错误,则虚拟函数如果存在,将保持初始化为 NULL
如果出现错误,则将该参数设置为新的 GError;调用者将拥有数据,并对其负责释放。

返回值

类型: GTlsInteractionResult

请求证书交互的状态。