gboolean g_authorize_method ( GDBusInterfaceSkeleton* self, GDBusMethodInvocation* invocation, gpointer user_data )
Emitted when a method is invoked by a remote caller and used to determine if the method call is authorized.
Note that this signal is emitted in a thread dedicated to handling the method call so handlers are allowed to perform blocking IO. This means that it is appropriate to call e.g. polkit_authority_check_authorization_sync() with the POLKIT_CHECK_AUTHORIZATION_FLAGS_ALLOW_USER_INTERACTION flag set.
FALSE is returned then no further handlers are run and the
signal handler must take a reference to
invocation and finish
handling the call (e.g. return an error via g_dbus_method_invocation_return_error()).
TRUE is returned, signal emission continues. If no
FALSE, then the method is dispatched. If
interface has an enclosing
GDBusObjectSkeleton, then the
GDBusObjectSkeleton::authorize-method signal handlers run before
the handlers for this signal.
The default class handler just returns
Please note that the common case is optimized: if no signals
handlers are connected and the default class handler isn’t
overridden (for both
interface and the enclosing
GDBusObjectSkeleton, if any) and
not have the
flags set, no dedicated thread is ever used and the call will be
handled in the same thread as the object that
to was exported in.
|Default handler: |
The default handler is called after the handlers added via
|Available since: 2.30|
The data is owned by the caller of the function.