Function
Giodbus_address_get_stream_sync
Declaration
GIOStream*
g_dbus_address_get_stream_sync (
const gchar* address,
gchar** out_guid,
GCancellable* cancellable,
GError** error
)
Description
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 value is a NUL terminated UTF-8 string. | |
out_guid |
gchar** |
|
|
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 value is a NUL terminated UTF-8 string. | |
cancellable |
GCancellable |
A |
|
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 |
|
The caller of the function takes ownership of the data, and is responsible for freeing it. |