[ Version ( since = "2.26" ) ]
public virtual bool acquire (Cancellable? cancellable = null) throws Error

Attempts to acquire the permission represented by this.

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 get_can_acquire before calling this function.

If the permission is acquired then true is returned. Otherwise, false is returned and throws is set appropriately.

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



a Permission instance


a Cancellable, or null


true if the permission was successfully acquired