Function

Giodbus_address_get_stream_sync

Declaration [src]

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

Description [src]

Synchronously connects to an endpoint specified by address and sets up the connection so it is in a state to run the client-side of the D-Bus authentication conversation. address must be in the D-Bus address format.

A server is not required to set a GUID, so out_guid may be set to NULL even on success.

This is a synchronous failable function. See g_dbus_address_get_stream() for the asynchronous version.

Available since:

2.26

Parameters

`address`	`const gchar*`
	A valid D-Bus address.
	The data is owned by the caller of the function.
	The string is a NUL terminated UTF-8 string.
`out_guid`	`gchar**`
	`NULL` or return location to store the GUID extracted from `address`, if any.
	The argument will be set by the function.
	The argument can be set to `NULL`.
	The argument can be `NULL`.
	The called function takes ownership of the data, and is responsible for freeing it.
	The string is a NUL terminated UTF-8 string.
`cancellable`	`GCancellable`
	A `GCancellable` or `NULL`.
	The argument can be `NULL`.
	The data is owned by the caller of the function.
`error`	`GError **`
	The return location for a `GError*`, or `NULL`.

Return value

Returns:	`GIOStream`
	A `GIOStream` or `NULL` if `error` is set.
	The caller of the function takes ownership of the data, and is responsible for freeing it.