方法

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,则必须将其初始化为 NULLGError*
如果没有错误,方法会保留初始化到 NULL 的参数。
如果出错,该参数将设置为一个新的已分配的 GError;调用者将接管数据,并负责释放它。

返回值

类型: GTlsInteractionResult

证书请求交互的状态。