虚函数

GioTlsInteractionask_password

自 2.30 版本起

声明 [源]

GTlsInteractionResult
ask_password (
  GTlsInteraction* interaction,
  GTlsPassword* password,
  GCancellable* cancellable,
  GError** error
)

描述 [源]

运行同步交互,提示用户输入密码。通常,应该使用 g_tls_interaction_invoke_ask_password() 而不是此函数。

派生的子类通常实现密码提示,尽管它们也可能选择从其他地方提供密码。将填充 password 值,然后调用 callback。或者,用户可能中断此密码请求,这通常会中断 TLS 连接。

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

自 2.30 版本起可用

参数

password

类型: GTlsPassword

一个 GTlsPassword 对象。

数据由方法的调用者拥有。
cancellable

类型: GCancellable

可选的 GCancellable 取消对象。

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

类型: GError **

可恢复错误的返回位置。

参数可以是 NULL
如果返回位置不是 NULL,则必须将其初始化为 NULL GError*
如果虚拟函数没有错误,则参数将保留为 NULL
如果出错,参数将设置为新分配的 GError;调用者将负责拥有数据,并负责释放它。

返回值

类型: GTlsInteractionResult

密码交互的状态。