tracker_data_provider_begin ()

GFileEnumerator *
tracker_data_provider_begin (TrackerDataProvider *data_provider,
                             GFile *url,
                             const gchar *attributes,
                             TrackerDirectoryFlags flags,
                             GCancellable *cancellable,
                             GError **error);

Creates a GFileEnumerator to enumerate children at the URI provided by url .

The attributes value is a string that specifies the file attributes that should be gathered. It is not an error if it's not possible to read a particular requested attribute from a file - it just won't be set. attributes should be a comma-separated list of attributes or attribute wildcards. The wildcard "*" means all attributes, and a wildcard like "standard::*" means all attributes in the standard namespace. An example attribute query be "standard::*,owner::user". The standard attributes are available as defines, like G_FILE_ATTRIBUTE_STANDARD_NAME. See g_file_enumerate_children() for more details.

Since: 1.2

tracker_data_provider_begin_async ()

void
tracker_data_provider_begin_async (TrackerDataProvider *data_provider,
                                   GFile *url,
                                   const gchar *attributes,
                                   TrackerDirectoryFlags flags,
                                   gint io_priority,
                                   GCancellable *cancellable,
                                   GAsyncReadyCallback callback,
                                   gpointer user_data);

Precisely the same operation as tracker_data_provider_begin() is performing, but asynchronously.

When all i/o for the operation is finished the callback will be called with the requested information.

See the documentation of TrackerDataProvider for information about the order of returned files.

In case of a partial error the callback will be called with any succeeding items and no error, and on the next request the error will be reported. If a request is cancelled the callback will be called with G_IO_ERROR_CANCELLED.

During an async request no other sync and async calls are allowed, and will result in G_IO_ERROR_PENDING errors.

Any outstanding i/o request with higher priority (lower numerical value) will be executed before an outstanding request with lower priority. Default priority is G_PRIORITY_DEFAULT.

Since: 1.2

tracker_data_provider_begin_finish ()

GFileEnumerator *
tracker_data_provider_begin_finish (TrackerDataProvider *data_provider,
                                    GAsyncResult *result,
                                    GError **error);

Finishes the asynchronous operation started with tracker_data_provider_begin_async().

Since: 1.2

struct TrackerDataProviderIface

struct TrackerDataProviderIface {
	GTypeInterface g_iface;

	/* Virtual Table */

	/* Start the data_provider for a given location, attributes and flags */
	GFileEnumerator *     (* begin)              (TrackerDataProvider    *data_provider,
	                                              GFile                  *url,
	                                              const gchar            *attributes,
	                                              TrackerDirectoryFlags   flags,
	                                              GCancellable           *cancellable,
	                                              GError                **error);
	void                  (* begin_async)        (TrackerDataProvider    *data_provider,
	                                              GFile                  *url,
	                                              const gchar            *attributes,
	                                              TrackerDirectoryFlags   flags,
	                                              gint                    io_priority,
	                                              GCancellable           *cancellable,
	                                              GAsyncReadyCallback     callback,
	                                              gpointer                user_data);
	GFileEnumerator *    (* begin_finish)       (TrackerDataProvider    *data_provider,
	                                              GAsyncResult           *result,
	                                              GError                **error);
};

Virtual methods left to implement.

TrackerDataProvider

typedef struct _TrackerDataProvider TrackerDataProvider;

An interface to enumerate URIs and feed the data to Tracker.