release


Description:

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

Attempts to release the permission represented by this.

The precise method by which this happens depends on the permission and the underlying authentication mechanism. In most cases the permission will be dropped immediately without further action.

You should check with get_can_release before calling this function.

If the permission is released 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 release_async for the non-blocking version.

Parameters:

this

a Permission instance

cancellable

a Cancellable, or null

Returns:

true if the permission was successfully released