Method
GioDBusConnectioncall
since: 2.26
Declaration [src]
void
g_dbus_connection_call (
  GDBusConnection* connection,
  const gchar* bus_name,
  const gchar* object_path,
  const gchar* interface_name,
  const gchar* method_name,
  GVariant* parameters,
  const GVariantType* reply_type,
  GDBusCallFlags flags,
  gint timeout_msec,
  GCancellable* cancellable,
  GAsyncReadyCallback callback,
  gpointer user_data
)
Description [src]
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 GVariant is floating, it is consumed. This allows
convenient ‘inline’ use of g_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
(see 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.
Available since: 2.26
This method completes asynchronously. Use g_dbus_connection_call_finish() inside the GAsyncReadyCallback to obtain the result of the operation.
Parameters
- bus_name
- 
            Type: const gchar*A unique or well-known bus name or NULLifconnectionis not a message bus connection.The argument can be NULL.The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. 
- object_path
- 
            Type: const gchar*Path of remote object. The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. 
- interface_name
- 
            Type: const gchar*D-Bus interface to invoke method on. The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. 
- method_name
- 
            Type: const gchar*The name of the method to invoke. The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. 
- parameters
- 
            Type: GVariantA GVarianttuple with parameters for the method orNULLif not passing parameters.The argument can be NULL.The data is owned by the caller of the method. 
- reply_type
- 
            Type: GVariantTypeThe expected type of the reply (which will be a tuple), or NULL.The argument can be NULL.The data is owned by the caller of the method. 
- flags
- 
            Type: GDBusCallFlagsFlags from the GDBusCallFlagsenumeration.
- timeout_msec
- 
            Type: gintThe timeout in milliseconds, -1 to use the default timeout or G_MAXINTfor no timeout.
- cancellable
- 
            Type: GCancellableA GCancellableorNULL.The argument can be NULL.The data is owned by the caller of the method. 
- callback
- 
            Type: GAsyncReadyCallbackA GAsyncReadyCallbackto call when the request is satisfied orNULLif you don’t care about the result of the method invocation.The argument can be NULL.
- user_data
- 
            Type: gpointerThe data to pass to callback.The argument can be NULL.The data is owned by the caller of the method.