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

a #GDBusAuthObserver or %NULL

cancellable Cancellable

a #GCancellable or %NULL

Return Value

a #GDBusConnection 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