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 gio.types.DBusProxyFlags.DoNotLoadProperties flag is used. Connect to the #GDBusProxy::g-properties-changed signal to get notified about property changes.

If the gio.types.DBusProxyFlags.DoNotConnectSignals 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 gio.types.DBusProxyFlags.DoNotLoadProperties and gio.types.DBusProxyFlags.DoNotConnectSignals are set, this constructor is guaranteed to complete immediately without blocking.

If name is a well-known name and the gio.types.DBusProxyFlags.DoNotAutoStart and gio.types.DBusProxyFlags.DoNotAutoStartAtConstruction 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 gio.dbus_proxy.DBusProxy.newFinish to get the result.

See gio.dbus_proxy.DBusProxy.newSync and for a synchronous version of this constructor.

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

class DBusProxy

static

void

new_

(

gio.dbus_connection.DBusConnection connection

gio.types.DBusProxyFlags flags

gio.dbus_interface_info.DBusInterfaceInfo info

string name

string objectPath

string interfaceName

gio.cancellable.Cancellable cancellable = null

gio.types.AsyncReadyCallback callback = null

)

Parameters

connection gio.dbus_connection.DBusConnection: A #GDBusConnection.
flags gio.types.DBusProxyFlags: Flags used when constructing the proxy.
info gio.dbus_interface_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 gio.cancellable.Cancellable: A #GCancellable or null.
callback gio.types.AsyncReadyCallback: Callback function to invoke when the proxy is ready.