Method

SecretPromptperform

Declaration [src]

void
secret_prompt_perform (
  SecretPrompt* self,
  const gchar* window_id,
  const GVariantType* return_type,
  GCancellable* cancellable,
  GAsyncReadyCallback callback,
  gpointer user_data
)

Description [src]

Runs a prompt and performs the prompting.

Returns TRUE if the prompt was completed and not dismissed.

If window_id is non-null then it is used as an XWindow id on Linux. The API expects this id to be converted to a string using the %d printf format. The Secret Service can make its prompt transient for the window with this id. In some Secret Service implementations this is not possible, so the behavior depending on this should degrade gracefully.

This method will return immediately and complete asynchronously.

Parameters

window_id const gchar*
 

String form of XWindow id for parent window to be transient for.

 The argument can be NULL.
 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
return_type GVariantType
 

The variant type of the prompt result.

 The data is owned by the caller of the function.
cancellable GCancellable
 

Optional cancellation object.

 The argument can be NULL.
 The data is owned by the caller of the function.
callback GAsyncReadyCallback
 

Called when the operation completes.

 The argument can be NULL.
user_data gpointer
 

Data to be passed to the callback.

 The argument can be NULL.
 The data is owned by the caller of the function.