gdbus proxy

### gdbus代理概述

D-Bus 是一种用于进程间通信 (IPC) 的消息总线系统，在 Linux 和其他类 Unix 操作系统上广泛使用。GDBus 提供了一组高级 API 来访问 D-Bus 功能[^1]。

对于 GDBus 代理，其主要作用是在客户端应用程序中表示远程对象。通过创建一个 `GDBusProxy` 实例，可以方便地调用远程接口的方法、接收信号以及获取属性值[^2]。

#include <gio/gio.h>

int main(int argc, char *argv[]) {
    g_type_init();

    // 创建连接到会话总线的 GDBusConnection 对象
    GError *error = NULL;
    GDBusConnection *connection =
        g_bus_get_sync(G_BUS_TYPE_SESSION, NULL, &error);
    
    if (!connection || error != NULL){
      printf("Failed to connect to session bus\n");
      return -1;
    }

    // 构建代理实例
    GDBusProxy *proxy = 
       g_dbus_proxy_new_sync(connection,
                             G_DBUS_PROXY_FLAGS_NONE,
                             NULL,
                             "org.freedesktop.NetworkManager", /* Bus name */
                             "/org/freedesktop/NetworkManager",/* Object path */
                             "org.freedesktop.DBus.Properties",/* Interface */
                             NULL,
                             &error);

    if(!proxy || error != NULL){
      printf("Failed creating proxy object.\n");
      return -1;
    }
}

此代码片段展示了如何建立与 D-Bus 总线之间的同步连接并构建一个新的 `GDBusProxy` 实例来代表 Network Manager 接口上的 Properties 接口[^3]。

当涉及到具体实现细节时：

- 使用者可以通过设置不同的标志位来自定义行为；
- 可以为特定的服务名称、对象路径和服务接口指定参数；
- 如果需要异步操作，则应考虑采用相应的函数版本如 `g_dbus_proxy_new()` 而不是上述例子中的 `_sync` 版本；
- 错误处理非常重要，应该始终检查返回的状态码和错误指针以确保程序能够正确响应异常情况；