构造函数

GioDBusProxynew_sync

since: 2.26

声明 [src]

GDBusProxy*
g_dbus_proxy_new_sync (
  GDBusConnection* connection,
  GDBusProxyFlags flags,
  GDBusInterfaceInfo* info,
  const gchar* name,
  const gchar* object_path,
  const gchar* interface_name,
  GCancellable* cancellable,
  GError** error
)

描述 [src]

创建一个代理，用于访问 interface_name 在 connection 中属于 name 的远程对象上的 object_path，并且除非使用了 G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES 标志，否则会同步加载 D-Bus 属性。

如果没有设置标志，也将设置信号匹配规则。连接到 GDBusProxy::g-signal 信号以处理来自远程对象的信号。

如果同时设置了 G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES 和 郭peq_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS，则此构造函数保证立即返回，而不会阻塞。

如果 name 是一个已知名称，并且没有设置 郭peq_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START 和 郭peq_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START_AT_CONSTRUCTION 标志并且没有当前存在名称所有者，则请求消息总线启动该名称的所有者。

这是一个同步且可失败的构造函数。有关异步版本的详细信息，请参阅 g_dbus_proxy_new 和 g_dbus_proxy_new_finish。

在 郭reqDBusProxy 中使用此 [示例][gdbus-wellknown-proxy]。

自2.26起可用

参数

connection

类型: GDBusConnection

一个 GDBusConnection。

数据由函数的调用者所有。

flags

类型: GDBusProxyFlags

构建代理时使用的标志。

info

类型: GDBusInterfaceInfo

一个指定 proxy 遵循的最小接口的 GDBusInterfaceInfo 或 NULL。

此参数可以为 NULL。

数据由函数的调用者所有。

name

类型: const gchar*

一个总线名称（已知或唯一），或者如果 connection 不是一个消息总线连接，则为 NULL。

此参数可以为 NULL。

数据由函数的调用者所有。

此值是一个以 NUL 结尾的 UTF-8 字符串。

object_path

类型: const gchar*

一个对象路径。

数据由函数的调用者所有。

此值是一个以 NUL 结尾的 UTF-8 字符串。

interface_name

类型: const gchar*

一个 D-Bus 接口名称。

数据由函数的调用者所有。

此值是一个以 NUL 结尾的 UTF-8 字符串。

cancellable

类型: GCancellable

一个 GCancellable 或 NULL。

此参数可以为 NULL。

数据由函数的调用者所有。

error

类型: GError **

恢复错误的位置。

此参数可以为 NULL。

如果返回位置不是 NULL，则必须将其初始化为 NULL GError*。

如果没有错误，构造函数将使用 NULL 初始化此参数。

如果发生错误，则参数将设置为一个新的 GError；调用者将接手数据，并负责释放它。

返回值

类型: GDBusProxy

返回一个 GDBusProxy 或如果设置错误则返回 NULL。使用 g_object_unref() 解引用以释放资源。

该函数的调用者将拥有这些数据，并负责将其释放。