Gio.DBusProxy.prototype.call
function call(method_name: String, parameters: GLib.Variant, flags: Gio.DBusCallFlags, timeout_msec: Number(gint), cancellable: Gio.Cancellable, callback: Gio.AsyncReadyCallback): void { // Gjs wrapper for g_dbus_proxy_call() }
Asynchronously invokes the method_name method on proxy.
If method_name contains any dots, then @name is split into interface and method name parts. This allows using proxy for invoking methods on other interfaces.
If the Gio.DBusConnection associated with proxy is closed then the operation will fail with Gio.IOErrorEnum.closed. If cancellable is canceled, the operation will fail with Gio.IOErrorEnum.cancelled. If parameters contains a value not compatible with the D-Bus protocol, the operation fails with Gio.IOErrorEnum.invalid_argument.
If the parameters GLib.Variant is floating, it is consumed. This allows convenient 'inline' use of GLib.Variant.new, e.g.: |[<!-- language="C" --> g_dbus_proxy_call (proxy, "TwoStrings", g_variant_new ("(ss)", "Thing One", "Thing Two"), G_DBUS_CALL_FLAGS_NONE, -1, NULL, (GAsyncReadyCallback) two_strings_done, &data); ]|
If proxy has an expected interface (see Gio.DBusProxy.g_interface_info) and method_name is referenced by it, then the return value is checked against the return type.
This is an asynchronous method. When the operation is finished, callback will be invoked in the [thread-default main context][g-main-context-push-thread-default] of the thread you are calling this method from. You can then call Gio.DBusProxy.prototype.call_finish to get the result of the operation. See Gio.DBusProxy.prototype.call_sync for the synchronous version of this method.
If callback is null then the D-Bus method call message will be sent with the Gio.DBusMessageFlags.no_reply_expected flag set.
Since 2.26
- method_name
Name of method to invoke.
- parameters
A GLib.Variant tuple with parameters for the signal or null if not passing parameters.
- flags
Flags from the Gio.DBusCallFlags enumeration.
- timeout_msec
The timeout in milliseconds (with %G_MAXINT meaning "infinite") or -1 to use the proxy default timeout.
- cancellable
A Gio.Cancellable or null.
- callback
A Gio.AsyncReadyCallback to call when the request is satisfied or null if you don't care about the result of the method invocation.