方法
GioTlsInteractioninvoke_request_certificate
自:2.40
声明 [src]
GTlsInteractionResult
g_tls_interaction_invoke_request_certificate (
GTlsInteraction* interaction,
GTlsConnection* connection,
GTlsCertificateRequestFlags flags,
GCancellable* cancellable,
GError** error
)
描述 [src]
调用交互以让用户选择用于连接的证书。在创建交互时,在主循环中调用此交互,特别是在 g_main_context_get_thread_default()
返回的 GMainContext
中。当对等实体在握手期间请求证书时,由 GTlsConnection
调用。
派生子类通常实现证书选择器,尽管它们也可以选择从其他地方提供证书。或者用户可以中止证书请求,这可能会也可能不会中止 TLS 连接。
实现可以是同步的(例如:模态对话框)或异步的(例如:非模态对话框)。该函数将负责正确调用其中任何一个。
如果交互被取消对象或用户取消,则返回 G_TLS_INTERACTION_FAILED
并包含具有 G_IO_ERROR_CANCELLED
错误代码的错误。某些实现可能不支持立即取消。
自:2.40
参数
connection
-
类型:
GTlsConnection
GTlsConnection
对象。数据由方法的调用者所有。 flags
-
类型:
GTlsCertificateRequestFlags
提供有关请求的更多信息的标志。
cancellable
-
类型:
GCancellable
一个可选的
GCancellable
取消对象。该参数可以是 NULL
。数据由方法的调用者所有。 error
-
类型:
GError **
一个可恢复错误的返回位置。
该参数可以是 NULL
。如果返回位置不是 NULL
,则必须将其初始化为NULL
的GError*
。如果没有错误,方法会保留初始化到 NULL
的参数。如果出错,该参数将设置为一个新的已分配的 GError
;调用者将接管数据,并负责释放它。