Cancellations

Cancellations — Cancelling requests.

Stability Level

, unless otherwise indicated

Synopsis

#include <libtracker-client/tracker.h>

gboolean            tracker_cancel_call                 (TrackerClient *client,
                                                         guint call_id);
gboolean            tracker_cancel_last_call            (TrackerClient *client);

Description

Tracker allows you to cancel any request that has not been processed yet. Aditionally, for fully synchronous requests, there is helper API to cancel the last request.

Details

tracker_cancel_call ()

gboolean            tracker_cancel_call                 (TrackerClient *client,
                                                         guint call_id);

The call_id is a guint which increments with each asynchronous API call made using libtracker-client. For synchronous API calls, see tracker_cancel_last_call() which is more useful.

`client` :	a TrackerClient.
`call_id` :	a guint id for the API call you want to cancel.
Returns :	A `gboolean` indicating if the call was cancelled or not.

tracker_cancel_last_call ()

gboolean            tracker_cancel_last_call            (TrackerClient *client);

Cancels the last API call made using tracker_cancel_call(). the last API call ID is always tracked so you don't have to provide it with this API.

`client` :	a TrackerClient.
Returns :	A gboolean indicating if the call was cancelled or not.

			Tracker Client Library Reference Manual
Top \| Description