DBusConnection.this

Synchronously connects and sets up a D-Bus client connection for exchanging D-Bus messages with an endpoint specified by address which must be in the D-Bus address format.

This constructor can only be used to initiate client-side connections - use g_dbus_connection_new_sync() if you need to act as the server. In particular, flags cannot contain the G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER or G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS flags.

This is a synchronous failable constructor. See g_dbus_connection_new_for_address() for the asynchronous version.

If observer is not NULL it may be used to control the authentication process.

Parameters

address string

a D-Bus address

flags GDBusConnectionFlags

flags describing how to make the connection

observer DBusAuthObserver
cancellable Cancellable

a gio.Cancellable or NULL

Return Value

a gio.DBusConnection or NULL if error is set. Free with g_object_unref().

Throws

GException on failure. ConstructionException GTK+ fails to create the object.

Meta

Since

2.26