Method

GioPermissionacquire

Declaration

gboolean
g_permission_acquire (
  GPermission* permission,
  GCancellable* cancellable,
  GError** error
)

Description

Attempts to acquire the permission represented by permission.

The precise method by which this happens depends on the permission and the underlying authentication mechanism. A simple example is that a dialog may appear asking the user to enter their password.

You should check with g_permission_get_can_acquire() before calling this function.

If the permission is acquired then TRUE is returned. Otherwise, FALSE is returned and error is set appropriately.

This call is blocking, likely for a very long time (in the case that user interaction is required). See g_permission_acquire_async() for the non-blocking version.

Available since:

2.26

Parameters

`cancellable`	`GCancellable`
	A `GCancellable`, or `NULL`.
	The argument can be `NULL`.
	The data is owned by the caller of the function.
`error`	`GError **`
	The return location for a `GError*`, or `NULL`.

Return value

Returns:	`gboolean`
	`TRUE` if the permission was successfully acquired.