|  |  |  | GIO Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
#include <gio/gio.h> gboolean g_dbus_is_address (const gchar *string); gboolean g_dbus_is_supported_address (const gchar *string,GError **error); void g_dbus_address_get_stream (const gchar *address,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); GIOStream * g_dbus_address_get_stream_finish (GAsyncResult *res,gchar **out_guid,GError **error); GIOStream * g_dbus_address_get_stream_sync (const gchar *address,gchar **out_guid,GCancellable *cancellable,GError **error); gchar * g_dbus_address_get_for_bus_sync (GBusType bus_type,GCancellable *cancellable,GError **error);
Routines for working with D-Bus addresses. A D-Bus address is a string like "unix:tmpdir=/tmp/my-app-name". The exact format of addresses is explained in detail in the D-Bus specification.
gboolean            g_dbus_is_address                   (const gchar *string);
Checks if string is a D-Bus address.
This doesn't check if string is actually supported by GDBusServer
or GDBusConnection - use g_dbus_is_supported_address() to do more
checks.
Since 2.26
gboolean g_dbus_is_supported_address (const gchar *string,GError **error);
Like g_dbus_is_address() but also checks if the library suppors the
transports in string and that key/value pairs for each transport
are valid.
| 
 | A string. | 
| 
 | Return location for error or NULL. | 
| Returns : | TRUEifstringis a valid D-Bus address that is
supported by this library,FALSEiferroris set. | 
Since 2.26
void g_dbus_address_get_stream (const gchar *address,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously 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.
When the operation is finished, callback will be invoked. You can
then call g_dbus_address_get_stream_finish() to get the result of
the operation.
This is an asynchronous failable function. See
g_dbus_address_get_stream_sync() for the synchronous version.
| 
 | A valid D-Bus address. | 
| 
 | A GCancellable or NULL. | 
| 
 | A GAsyncReadyCallback to call when the request is satisfied. | 
| 
 | Data to pass to callback. | 
Since 2.26
GIOStream * g_dbus_address_get_stream_finish (GAsyncResult *res,gchar **out_guid,GError **error);
Finishes an operation started with g_dbus_address_get_stream().
| 
 | A GAsyncResult obtained from the GAsyncReadyCallback passed to g_dbus_address_get_stream(). | 
| 
 | NULLor return location to store the GUID extracted fromaddress, if any. | 
| 
 | Return location for error or NULL. | 
| Returns : | A GIOStream or NULLiferroris set. [transfer full] | 
Since 2.26
GIOStream * g_dbus_address_get_stream_sync (const gchar *address,gchar **out_guid,GCancellable *cancellable,GError **error);
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.
This is a synchronous failable function. See
g_dbus_address_get_stream() for the asynchronous version.
| 
 | A valid D-Bus address. | 
| 
 | NULLor return location to store the GUID extracted fromaddress, if any. | 
| 
 | A GCancellable or NULL. | 
| 
 | Return location for error or NULL. | 
| Returns : | A GIOStream or NULLiferroris set. [transfer full] | 
Since 2.26
gchar * g_dbus_address_get_for_bus_sync (GBusType bus_type,GCancellable *cancellable,GError **error);
Synchronously looks up the D-Bus address for the well-known message
bus instance specified by bus_type. This may involve using various
platform specific mechanisms.
| 
 | A GBusType. | 
| 
 | A GCancellable or NULL. | 
| 
 | Return location for error or NULL. | 
| Returns : | A valid D-Bus address string for bus_typeorNULLiferroris set. | 
Since 2.26