DBusProxy.newSync

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)

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].

Parameters

connectionA #GDBusConnection.
flagsFlags used when constructing the proxy.
infoA #GDBusInterfaceInfo specifying the minimal interface that proxy conforms to or null.
nameA bus name (well-known or unique) or null if connection is not a message bus connection.
objectPathAn object path.
interfaceNameA D-Bus interface name.
cancellableA #GCancellable or null.

Returns

A #GDBusProxy or null if error is set.

Free with [gobject.object.ObjectWrap.unref].

Throws

[ErrorWrap]