方法
GioTlsInteractionrequest_certificate
since: 2.40
声明 [src]
GTlsInteractionResult
g_tls_interaction_request_certificate (
GTlsInteraction* interaction,
GTlsConnection* connection,
GTlsCertificateRequestFlags flags,
GCancellable* cancellable,
GError** error
)
描述 [src]
运行同步交互以要求用户选择与连接一起使用的证书。通常应使用 g_tls_interaction_invoke_request_certificate() 而不是此函数。
派生子类通常实现证书选择器，尽管它们也可以选择从别处提供证书。Alternatively the user may abort this certificate request, which will usually abort the TLS connection.
如果返回 G_TLS_INTERACTION_HANDLED，则传递给 g_tls_interaction_request_certificate() 的 GTlsConnection 将填充 GTlsConnection:certificate。
如果交互被取消对象或用户取消，则返回 G_TLS_INTERACTION_FAILED 并包含一个包含 G_IO_ERROR_CANCELLED 错误代码的错误。某些实现可能不支持即时取消。
Available since: 2.40
参数
connection-
类型：
GTlsConnectionGTlsConnection对象。数据由方法调用者拥有。 flags-
类型：
GTlsCertificateRequestFlags提供更多请求信息的标志。
cancellable-
类型：
GCancellable一个可选的
GCancellable取消对象。该参数可以为 NULL。数据由方法调用者拥有。 error-
类型：
GError **用于可恢复错误的返回位置。
该参数可以为 NULL。如果返回位置不为 NULL，则必须将其初始化为NULLGError*。如果没有错误，方法将留下初始化为 NULL的参数。如果发生错误，则将参数设置为新分配的 GError；调用者将获得数据的所有权，并负责释放它。