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