Gio.Permission.prototype.acquire
function acquire(cancellable: Gio.Cancellable): Boolean {
// Gjs wrapper for g_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 Gio.Permission.prototype.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 Gio.Permission.prototype.acquire_async for the non-blocking version.
Since 2.26
- cancellable
a Gio.Cancellable, or null
- Returns
true if the permission was successfully acquired