函数

giodbus_address_get_stream_sync

自：2.26

声明 [src]

GIOStream*
g_dbus_address_get_stream_sync (
  const gchar* address,
  gchar** out_guid,
  GCancellable* cancellable,
  GError** error
)

描述 [src]

同步连接到由 address 指定的端点，并设置连接以便它可以运行客户端的 D-Bus 认证对话。 address 必须是 D-Bus 地址格式。

服务器不需要设置 GUID，因此即使成功，out_guid 也可能被设置为 NULL。

这是一个同步的可能会失败的函数。有关异步版本，请参阅 g_dbus_address_get_stream()。

自：2.26

参数

address

类型： const gchar*

一个有效的 D-Bus 地址。

数据由函数的调用者拥有。
值是一个以 NUL 结尾的 UTF-8 字符串。
out_guid

类型： gchar**

如果是 NULL 或者用于存储从 address 中提取的 GUID（如果有）的返回位置。

该参数将由函数设置。
函数可以将该参数设置为 NULL。
该参数可以是 NULL。
函数的调用者将获取返回数据的所有权，并负责释放它。
值是一个以 NUL 结尾的 UTF-8 字符串。
cancellable

类型： GCancellable

一个 GCancellable 或 NULL。

该参数可以是 NULL。
数据由函数的调用者拥有。
error

类型： GError **

一个可恢复错误的返回位置。

该参数可以是 NULL。
如果返回位置不是 NULL，则必须将它初始化为 NULL GError*。
如果没有错误，函数将留下初始化的 NULL。
在发生错误的情况下，该参数将被设置为一个新的分配的 GError；调用者将接管数据的所有权，并负责释放它。

返回值

类型： GIOStream

一个 GIOStream 或如果 error 已设置则 NULL。

函数的调用者将获取数据的所有权，并负责释放它。