acquire
Description:
[ Version ( since = "2.26" ) ]
public virtual bool acquire (Cancellable? cancellable = null) throws Error
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.
Parameters:
this |
a Permission instance |
cancellable |
a Cancellable, or null |
Returns:
true if the permission was successfully acquired |