连接管理

建立与断开打印服务的连接。

tijet_client_connect

连接到打印服务。

自动识别地址类型:

  • 包含 : 后跟数字端口(如 127.0.0.1:50051)→ TCP 直连

  • 其他非空字符串 → Unix Domain Socket(自动添加 unix: 前缀)

  • NULL 或空字符串 → 使用 TIJET_DEFAULT_UDS_PATH

  • client: 客户端句柄。

  • address: 服务地址(UTF-8 字符串)。传 NULL 或空字符串使用默认 UDS 路径。

  • 返回: TIJET_OK — 连接成功

  • 返回: TIJET_ERR_INVALID_ARG — client 为 NULL

  • 返回: TIJET_ERR_TIMEOUT — 连接超时

  • 返回: TIJET_ERR_SERVER — 服务端拒绝连接

注意: 重复调用会先断开当前连接再重新连接。 参见: tijet_client_disconnect() 参见: TIJET_DEFAULT_UDS_PATH

tijet_client_disconnect

断开与服务端的连接。

自动停止事件订阅和日志订阅(若已启动),安全关闭 gRPC channel。 未连接时调用是安全的(空操作)。

  • client: 客户端句柄。
  • 返回: TIJET_OK — 断开成功
  • 返回: TIJET_ERR_INVALID_ARG — client 为 NULL

tijet_client_is_connected

查询是否已连接。

  • client: 客户端句柄。 返回: 0 未连接 或 client 为 NULL 返回: 1 已连接