Permission.acquire

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.

class Permission
bool
acquire

Parameters

cancellable Cancellable

a #GCancellable, or %NULL

Return Value

Type: bool

%TRUE if the permission was successfully acquired

Throws

GException on failure.

Meta

Since

2.26