DBusProxy.new_

Creates a proxy for accessing @interface_name on the remote object at @object_path owned by @name at @connection and asynchronously loads D-Bus properties unless the %G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES flag is used. Connect to the #GDBusProxy::g-properties-changed signal to get notified about property changes.

If the %G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS flag is not set, also sets up match rules for signals. Connect to the #GDBusProxy::g-signal signal to handle signals from the remote object.

If both %G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES and %G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS are set, this constructor is guaranteed to complete immediately without blocking.

If @name is a well-known name and the %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START and %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START_AT_CONSTRUCTION flags aren't set and no name owner currently exists, the message bus will be requested to launch a name owner for the name.

This is a failable asynchronous constructor - when the proxy is ready, @callback will be invoked and you can use g_dbus_proxy_new_finish() to get the result.

See g_dbus_proxy_new_sync() and for a synchronous version of this constructor.

#GDBusProxy is used in this example[gdbus-wellknown-proxy].

Parameters

connection DBusConnection

A #GDBusConnection.

flags GDBusProxyFlags

Flags used when constructing the proxy.

info DBusInterfaceInfo

A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.

name string

A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.

objectPath string

An object path.

interfaceName string

A D-Bus interface name.

cancellable Cancellable

A #GCancellable or %NULL.

callback GAsyncReadyCallback

Callback function to invoke when the proxy is ready.

userData void*

User data to pass to @callback.

Meta

Since

2.26