Function
GcrSystemPromptopen_for_prompter
Declaration [src]
GcrPrompt*
gcr_system_prompt_open_for_prompter (
const gchar* prompter_name,
gint timeout_seconds,
GCancellable* cancellable,
GError** error
)
Description [src]
Opens a system prompt. If prompter_name is NULL, then the default
system prompter is used.
Most system prompters only allow showing one prompt at a time, and if
another prompt is shown then this method will block for up to
timeout_seconds seconds. If timeout_seconds is equal to -1, then this
will block indefinitely until the prompt can be opened. If timeout_seconds
expires, then this function will fail with a GCR_SYSTEM_PROMPT_IN_PROGRESS
error.
Parameters
prompter_name-
Type:
const gchar*The prompter dbus name.
The argument can be NULL.The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. timeout_seconds-
Type:
gintThe number of seconds to wait to access the prompt, or -1.
cancellable-
Type:
GCancellableOptional cancellation object.
The argument can be NULL.The data is owned by the caller of the function. error-
Type:
GError **The return location for a recoverable error.
The argument can be NULL.If the return location is not NULL, then you must initialize it to aNULLGError*.The argument will be left initialized to NULLby the function if there are no errors.In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.
Return value
Type: GcrSystemPrompt
The prompt, or NULL if
prompt could not be opened.
| The caller of the function takes ownership of the data, and is responsible for freeing it. |