方法

GioTlsInteractionask_password

since: 2.30

声明 [src]

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

描述 [src]

运行同步交互，向用户请求密码。一般情况下，应使用 g_tls_interaction_invoke_ask_password() 而不是此函数。

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

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

since: 2.30

参数

password

类型: GTlsPassword

一个 GTlsPassword 对象。

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

cancellable

类型: GCancellable

可选的 GCancellable 取消对象。

该参数可以为 NULL。

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

error

类型: GError **

恢复错误的返回位置。

该参数可以为 NULL。

如果返回位置不是 NULL，则必须将其初始化为 NULL GError*。

如果没有错误，方法将保留初始化参数为 NULL。

在出错的情况下，该参数将被设置为一个新的 GError；调用者将负责管理数据，并且将对它负责。

返回值

类型: GTlsInteractionResult

请求密码交互的状态。