new

fun new(connection: DBusConnection, flags: DBusProxyFlags, info: DBusInterfaceInfo? = null, name: String? = null, objectPath: String, interfaceName: String, cancellable: Cancellable? = null, callback: AsyncReadyCallback?)

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 gdbus-wellknown-proxy.

Since

2.26

Parameters

connection

A #GDBusConnection.

flags

Flags used when constructing the proxy.

info

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

name

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

objectPath

An object path.

interfaceName

A D-Bus interface name.

cancellable

A #GCancellable or null.

callback

Callback function to invoke when the proxy is ready.