虚拟方法
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
;调用者将拥有数据,并对其负责释放。