虚函数
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
;调用者将负责拥有数据,并负责释放它。