Virtual Method

ValentApplicationPlugindbus_register

unstable since: 1.0

Declaration [src]

gboolean
dbus_register (
  ValentApplicationPlugin* plugin,
  GDBusConnection* connection,
  const char* object_path,
  GError** error
)

Description [src]

Handle the D-Bus registration phase of the application.

Implementations may override this method to export extra objects on the bus, that need to exist before the application tries to own the bus name.

D-Bus registration will be aborted if FALSE is returned, so implementations may return TRUE and report the error by other means if it is not intended to be fatal.

Available since: 1.0

Parameters

connection

Type: GDBusConnection

A Gio.DBusCOnnection

The data is owned by the caller of the function.
object_path

Type: const char*

A D-Bus object path.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
error

Type: GError **

The return location for a recoverable error.

The argument can be NULL.
If the return location is not NULL, then you must initialize it to a NULL GError*.
The argument will be left initialized to NULL by the virtual function if there are no errors.
In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.

Return value

Type: gboolean

TRUE, or FALSE with error set.