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.
If 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
return_error).
Otherwise, if true is returned, signal emission continues. If no handlers return
false, then the method is dispatched. If interface has an enclosing
DBusObjectSkeleton, then the
authorize_method signal handlers run before the handlers for
this signal.
The default class handler just returns true.
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 DBusObjectSkeleton, if any) and
g_flags does not have the
g_dbus_interface_skeleton_flags_handle_method_invocations_in_thread flags set, no dedicated thread is ever used and the call will
be handled in the same thread as the object that interface belongs to was exported in.
| invocation |
|
true if the call is authorized, false otherwise. |