方法
GioTlsInteractioninvoke_ask_password
since: 2.30
声明 [src]
GTlsInteractionResult
g_tls_interaction_invoke_ask_password (
GTlsInteraction* interaction,
GTlsPassword* password,
GCancellable* cancellable,
GError** error
)
描述 [src]
调用交互以提示用户输入密码。此方法在主循环中调用此交互，具体为在交互创建时由 g_main_context_get_thread_default() 返回的 GMainContext。这通常由 GTlsConnection 或 GTlsDatabase 调用来提示用户输入密码。
子类通常会实现密码提示对话框，尽管它们也可以选择从其他地方提供密码。随后将填充 password 值并调用 callback。用户也可能取消此密码请求，这通常会导致终止 TLS 连接。
实现可以是同步的（例如模态对话框）或异步的（例如非模态对话框）。此函数将正确调用任何一个。
如果交互被取消对象或用户取消，则返回 G_TLS_INTERACTION_FAILED，其中包含一个包含 G_IO_ERROR_CANCELLED 错误码的错误。某些实现可能不支持立即取消。
since: 2.30
参数
password-
类型:
GTlsPasswordGTlsPassword对象。数据由方法调用者拥有。 cancellable-
类型:
GCancellable可选的
GCancellable取消对象。该参数可以是 NULL。数据由方法调用者拥有。 error-
类型:
GError **用于恢复错误的返回位置的 GError。
该参数可以是 NULL。如果返回位置不是 NULL，则必须将其初始化为NULL的GError*。如果没有错误，该参数将被初始化为 NULL。如果发生错误，该参数将被设置为新的 GError；调用者将获取数据的所有权，并负责释放它。