## Cancellations

Cancellations — Cancelling requests.

## 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.