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 g_permission_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 g_permission_acquire_async() for
the non-blocking version.

Parameters:

Gio.Cancellable cancellable

a GCancellable, or NULL

Returns:

gboolean TRUE if the permission was successfully acquired

Attempts to acquire the permission represented by permission.
This is the first half of the asynchronous version of
g_permission_acquire().

Parameters:

Gio.Cancellable cancellable

a GCancellable, or NULL

Function (Object source_object, AsyncResult res, void* user_data) : none Required (not null)

the GAsyncReadyCallback to call when done

void* user_data Required (not null)

the user data to pass to callback

Returns:

none

Collects the result of attempting to acquire the permission
represented by permission.
This is the second half of the asynchronous version of
g_permission_acquire().

Parameters:

Gio.AsyncResult result Required (not null)

the GAsyncResult given to the GAsyncReadyCallback

Returns:

gboolean TRUE if the permission was successfully acquired

Gets the value of the 'allowed' property. This property is TRUE if
the caller currently has permission to perform the action that

Returns:

gboolean the value of the 'allowed' property

Gets the value of the 'can-acquire' property. This property is TRUE
if it is generally possible to acquire the permission by calling
g_permission_acquire().

Returns:

gboolean the value of the 'can-acquire' property

Gets the value of the 'can-release' property. This property is TRUE
if it is generally possible to release the permission by calling
g_permission_release().

Returns:

gboolean the value of the 'can-release' property

This function is called by the GPermission implementation to update
the properties of the permission. You should never call this
function except from a GPermission implementation.
GObject notify signals are generated, as appropriate.

Parameters:

gboolean allowed Required (not null)

the new value for the 'allowed' property

gboolean can_acquire Required (not null)

the new value for the 'can-acquire' property

gboolean can_release Required (not null)

the new value for the 'can-release' property

Returns:

none

Initializes the object implementing the interface. This must be
done before any real use of the object after initial construction.
Implementations may also support cancellation. If cancellable is not NULL,
then initialization can be cancelled by triggering the cancellable object
from another thread. If the operation was cancelled, the error
G_IO_ERROR_CANCELLED will be returned. If cancellable is not NULL and
the object doesn't support cancellable initialization the error
G_IO_ERROR_NOT_SUPPORTED will be returned.
If this function is not called, or returns with an error then all
operations on the object should fail, generally returning the
error G_IO_ERROR_NOT_INITIALIZED.
Implementations of this method must be idempotent, i.e. multiple calls
to this function with the same argument should return the same results.
Only the first call initializes the object, further calls return the result
of the first call. This is so that its safe to implement the singleton
pattern in the GObject constructor function.
return FALSE and set error appropriately if present.

Parameters:

Gio.Cancellable cancellable

optional GCancellable object, NULL to ignore.

Returns:

gboolean TRUE if successful. If an error has occurred, this function will

Starts asynchronous initialization of the object implementing the
interface. This must be done before any real use of the object after
initial construction. If the object also implements GInitable you can
optionally call g_initable_init() instead.
When the initialization is finished, callback will be called. You can
then call g_async_initable_init_finish() to get the result of the
initialization.
Implementations may also support cancellation. If cancellable is not
NULL, then initialization can be cancelled by triggering the cancellable
object from another thread. If the operation was cancelled, the error
G_IO_ERROR_CANCELLED will be returned. If cancellable is not NULL, and
the object doesn't support cancellable initialization, the error
G_IO_ERROR_NOT_SUPPORTED will be returned.
If this function is not called, or returns with an error, then all
operations on the object should fail, generally returning the
error G_IO_ERROR_NOT_INITIALIZED.
to this function with the same argument should return the same results.
Only the first call initializes the object; further calls return the result
of the first call. This is so that it's safe to implement the singleton
pattern in the GObject constructor function.
For classes that also support the GInitable interface, the default
implementation of this method will run the g_initable_init() function
in a thread, so if you want to support asynchronous initialization via
threads, just implement the GAsyncInitable interface without overriding
any interface methods.

Parameters:

gint32 io_priority Required (not null)

the I/O priority of the operation.

Gio.Cancellable cancellable

optional GCancellable object, NULL to ignore.

Function (Object source_object, AsyncResult res, void* user_data) : none Required (not null)

a GAsyncReadyCallback to call when the request is satisfied

void* user_data Required (not null)

the data to pass to callback function

Returns:

none

Finishes asynchronous initialization and returns the result.
See g_async_initable_init_async().
will return FALSE and set error appropriately if present.

Parameters:

Gio.AsyncResult res Required (not null)

a GAsyncResult.

Returns:

gboolean TRUE if successful. If an error has occurred, this function

Finishes the async construction for the various g_async_initable_new calls,
returning the created object or NULL on error.
g_object_unref().

Parameters:

Gio.AsyncResult res Required (not null)

the GAsyncResult.from the callback

Returns:

GObject.Object a newly created GObject, or NULL on error. Free with

Attempts to release the permission represented by permission.
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 g_permission_get_can_release() before calling
this function.
If the permission is released 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 g_permission_release_async() for
the non-blocking version.

Parameters:

Gio.Cancellable cancellable

a GCancellable, or NULL

Returns:

gboolean TRUE if the permission was successfully released

Attempts to release the permission represented by permission.
This is the first half of the asynchronous version of
g_permission_release().

Parameters:

Gio.Cancellable cancellable

a GCancellable, or NULL

Function (Object source_object, AsyncResult res, void* user_data) : none Required (not null)

the GAsyncReadyCallback to call when done

void* user_data Required (not null)

the user data to pass to callback

Returns:

none

Collects the result of attempting to release the permission
represented by permission.
This is the second half of the asynchronous version of
g_permission_release().

Parameters:

Gio.AsyncResult result Required (not null)

the GAsyncResult given to the GAsyncReadyCallback

Returns:

gboolean TRUE if the permission was successfully released