Constructor

GioDBusProxynew_for_bus_sync

since: 2.26

Declaration [src] 

GDBusProxy*
g_dbus_proxy_new_for_bus_sync (
  GBusType bus_type,
  GDBusProxyFlags flags,
  GDBusInterfaceInfo* info,
  const gchar* name,
  const gchar* object_path,
  const gchar* interface_name,
  GCancellable* cancellable,
  GError** error
)

Description [src]

Like g_dbus_proxy_new_sync() but takes a GBusType instead of a GDBusConnection.

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

Available since: 2.26

Parameters

bus_type

Type: GBusType

A GBusType.

flags

Type: GDBusProxyFlags

Flags used when constructing the proxy.

info

Type: GDBusInterfaceInfo

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

The argument can be NULL.
The data is owned by the caller of the function.
name

Type: const gchar*

A bus name (well-known or unique).

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
object_path

Type: const gchar*

An object path.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
interface_name

Type: const gchar*

A D-Bus interface name.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
cancellable

Type: GCancellable

A GCancellable or NULL.

The argument can be NULL.
The data is owned by the caller of the function.
error

Type: GError **

The return location for a recoverable error.

The argument can be NULL.
If the return location is not NULL, then you must initialize it to a NULL GError*.
The argument will be left initialized to NULL by the constructor if there are no errors.
In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.

Return value

Type: GDBusProxy

A GDBusProxy or NULL if error is set. Free with g_object_unref().

The caller of the function takes ownership of the data, and is responsible for freeing it.