Constructor

TrackerSparqlConnectionbus_new

Declaration [src]

TrackerSparqlConnection*
tracker_sparql_connection_bus_new (
  const gchar* service_name,
  const gchar* object_path,
  GDBusConnection* dbus_connection,
  GError** error
)

Description [src]

service_name (nullable): The name of the D-Bus service to connect to, or NULL if not using a message bus. Connects to a database owned by another process on the local machine via DBus.

When using a message bus (session/system), the service_name argument will be used to describe the remote endpoint, either by unique or well-known D-Bus names. If not using a message bus (e.g. peer-to-peer D-Bus connections) the service_name may be NULL.

The D-Bus object path of the remote endpoint will be given through object_path, NULL may be used to use the default /org/freedesktop/Tracker3/Endpoint path.

The D-Bus connection used to set up the connection may be given through the dbus_connection argument. Using NULL will resort to the default session bus.

Parameters

`service_name`	`const gchar*`
	No description available.
	The data is owned by the caller of the function.
	The string is a NUL terminated UTF-8 string.
`object_path`	`const gchar*`
	The path to the object, or `NULL` to use the default.
	The argument can be `NULL`.
	The data is owned by the caller of the function.
	The string is a NUL terminated UTF-8 string.
`dbus_connection`	`GDBusConnection*`
	The `GDBusConnection` to use, or `NULL` to use the session bus.
	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:	`TrackerSparqlConnection`
	A new `TrackerSparqlConnection`.
	The caller of the function takes ownership of the data, and is responsible for freeing it.