GClueLocationProxy: Libgeoclue Reference Manual

GClueLocationProxy

Functions

void	gclue_location_proxy_new ()
GClueLocation *	gclue_location_proxy_new_finish ()
GClueLocation *	gclue_location_proxy_new_sync ()
void	gclue_location_proxy_new_for_bus ()
GClueLocation *	gclue_location_proxy_new_for_bus_finish ()
GClueLocation *	gclue_location_proxy_new_for_bus_sync ()

Object Hierarchy

    GObject
    ╰── GDBusProxy
        ╰── GClueLocationProxy

Description

Functions

gclue_location_proxy_new ()

void
gclue_location_proxy_new (GDBusConnection *connection,
                          GDBusProxyFlags flags,
                          const gchar *name,
                          const gchar *object_path,
                          GCancellable *cancellable,
                          GAsyncReadyCallback callback,
                          gpointer user_data);

Asynchronously creates a proxy for the D-Bus interface org.freedesktop.GeoClue2.Location. See g_dbus_proxy_new() for more details.

When the operation is finished, callback will be invoked in the thread-default main loop of the thread you are calling this method from. You can then call gclue_location_proxy_new_finish() to get the result of the operation.

See gclue_location_proxy_new_sync() for the synchronous, blocking version of this constructor.

Parameters

connection	A GDBusConnection.
flags	Flags from the GDBusProxyFlags enumeration.
name	A bus name (well-known or unique) or `NULL` if `connection` is not a message bus connection.	[nullable]
object_path	An object path.
cancellable	A GCancellable or `NULL`.	[nullable]
callback	A GAsyncReadyCallback to call when the request is satisfied.
user_data	User data to pass to `callback` .

gclue_location_proxy_new_finish ()

GClueLocation *
gclue_location_proxy_new_finish (GAsyncResult *res,
                                 GError **error);

Finishes an operation started with gclue_location_proxy_new().

Parameters

res	The GAsyncResult obtained from the GAsyncReadyCallback passed to `gclue_location_proxy_new()`.
error	Return location for error or `NULL`

Returns

The constructed proxy object or NULL if error is set.

[transfer full][type GClueLocationProxy]

gclue_location_proxy_new_sync ()

GClueLocation *
gclue_location_proxy_new_sync (GDBusConnection *connection,
                               GDBusProxyFlags flags,
                               const gchar *name,
                               const gchar *object_path,
                               GCancellable *cancellable,
                               GError **error);

Synchronously creates a proxy for the D-Bus interface org.freedesktop.GeoClue2.Location. See g_dbus_proxy_new_sync() for more details.

The calling thread is blocked until a reply is received.

See gclue_location_proxy_new() for the asynchronous version of this constructor.

Parameters

connection	A GDBusConnection.
flags	Flags from the GDBusProxyFlags enumeration.
name	A bus name (well-known or unique) or `NULL` if `connection` is not a message bus connection.	[nullable]
object_path	An object path.
cancellable	A GCancellable or `NULL`.	[nullable]
error	Return location for error or `NULL`

Returns

The constructed proxy object or NULL if error is set.

[transfer full][type GClueLocationProxy]

gclue_location_proxy_new_for_bus ()

void
gclue_location_proxy_new_for_bus (GBusType bus_type,
                                  GDBusProxyFlags flags,
                                  const gchar *name,
                                  const gchar *object_path,
                                  GCancellable *cancellable,
                                  GAsyncReadyCallback callback,
                                  gpointer user_data);

Like gclue_location_proxy_new() but takes a GBusType instead of a GDBusConnection.

See gclue_location_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.

Parameters

bus_type	A GBusType.
flags	Flags from the GDBusProxyFlags enumeration.
name	A bus name (well-known or unique).
object_path	An object path.
cancellable	A GCancellable or `NULL`.	[nullable]
callback	A GAsyncReadyCallback to call when the request is satisfied.
user_data	User data to pass to `callback` .

gclue_location_proxy_new_for_bus_finish ()

GClueLocation *
gclue_location_proxy_new_for_bus_finish
                               (GAsyncResult *res,
                                GError **error);

Finishes an operation started with gclue_location_proxy_new_for_bus().

Parameters

res	The GAsyncResult obtained from the GAsyncReadyCallback passed to `gclue_location_proxy_new_for_bus()`.
error	Return location for error or `NULL`

Returns

The constructed proxy object or NULL if error is set.

[transfer full][type GClueLocationProxy]

gclue_location_proxy_new_for_bus_sync ()

GClueLocation *
gclue_location_proxy_new_for_bus_sync (GBusType bus_type,
                                       GDBusProxyFlags flags,
                                       const gchar *name,
                                       const gchar *object_path,
                                       GCancellable *cancellable,
                                       GError **error);

Like gclue_location_proxy_new_sync() but takes a GBusType instead of a GDBusConnection.

The calling thread is blocked until a reply is received.

See gclue_location_proxy_new_for_bus() for the asynchronous version of this constructor.

Parameters

bus_type	A GBusType.
flags	Flags from the GDBusProxyFlags enumeration.
name	A bus name (well-known or unique).
object_path	An object path.
cancellable	A GCancellable or `NULL`.	[nullable]
error	Return location for error or `NULL`

Returns

The constructed proxy object or NULL if error is set.

[transfer full][type GClueLocationProxy]