DBusConnection.call

Asynchronously invokes the method_name method on the interface_name D-Bus interface on the remote object at object_path owned by bus_name.

If connection is closed then the operation will fail with G_IO_ERROR_CLOSED. If cancellable is canceled, the operation will fail with G_IO_ERROR_CANCELLED. If parameters contains a value not compatible with the D-Bus protocol, the operation fails with G_IO_ERROR_INVALID_ARGUMENT.

If reply_type is non-NULL then the reply will be checked for having this type and an error will be raised if it does not match. Said another way, if you give a reply_type then any non-NULL return value will be of this type. Unless it’s G_VARIANT_TYPE_UNIT, the reply_type will be a tuple containing one or more values.

If the parameters glib.Variant is floating, it is consumed. This allows convenient 'inline' use of Variant.new, e.g.:

g_dbus_connection_call (connection,
"org.freedesktop.StringThings",
"/org/freedesktop/StringThings",
"org.freedesktop.StringThings",
"TwoStrings",
g_variant_new ("(ss)",
"Thing One",
"Thing Two"),
NULL,
G_DBUS_CALL_FLAGS_NONE,
-1,
NULL,
(GAsyncReadyCallback) two_strings_done,
NULL);

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 g_dbus_connection_call_finish() to get the result of the operation. See g_dbus_connection_call_sync() for the synchronous version of this function.

If callback is NULL then the D-Bus method call message will be sent with the G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED flag set.

class DBusConnection

void

call

(

string busName

string objectPath

string interfaceName

string methodName

Variant parameters

VariantType replyType

GDBusCallFlags flags

int timeoutMsec

Cancellable cancellable

GAsyncReadyCallback callback

void* userData

)

Parameters

busName string: a unique or well-known bus name or NULL if connection is not a message bus connection
objectPath string: path of remote object
interfaceName string: D-Bus interface to invoke method on
methodName string: the name of the method to invoke
parameters Variant: a glib.Variant tuple with parameters for the method or NULL if not passing parameters
replyType VariantType: the expected type of the reply (which will be a tuple), or NULL
flags GDBusCallFlags: flags from the GDBusCallFlags enumeration
timeoutMsec int: the timeout in milliseconds, -1 to use the default timeout or G_MAXINT for no timeout
cancellable Cancellable: a gio.Cancellable or NULL
callback GAsyncReadyCallback: a GAsyncReadyCallback to call when the request is satisfied or NULL if you don't care about the result of the method invocation
userData void*: the data to pass to callback

DBusConnection.call

Parameters

Meta

Since