DBusProxy.newSync

Creates a proxy for accessing interface_name on the remote object at object_path owned by name at connection and synchronously loads D-Bus properties unless the gio.types.DBusProxyFlags.DoNotLoadProperties flag is used.

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 return 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 synchronous failable constructor. See gio.dbus_proxy.DBusProxy.new_ and gio.dbus_proxy.DBusProxy.newFinish for the asynchronous version.

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

class DBusProxy

static

gio.dbus_proxy.DBusProxy

newSync

(

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

)

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.

Return Value

Type: gio.dbus_proxy.DBusProxy

A #GDBusProxy or null if error is set. Free with gobject.object.ObjectG.unref.