acquire

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