Method

GrlSourcequery

since: 0.2.0

Declaration [src]

guint
grl_source_query (
  GrlSource* source,
  const gchar* query,
  const GList* keys,
  GrlOperationOptions* options,
  GrlSourceResultCb callback,
  gpointer user_data
)

Description [src]

Execute a specialized query (specific for each provider) on a media repository.

It is different from grl_source_search() semantically, because the query implies a carefully crafted string, rather than a simple string to search.

This method is asynchronous.

Available since: 0.2.0

Parameters

query

Type: const gchar*

The query to process.

The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
keys

Type: A list of None

The GList of GrlKeyIDs to request.

The data is owned by the caller of the method.
options

Type: GrlOperationOptions

Options wanted for that operation.

The data is owned by the caller of the method.
callback

Type: GrlSourceResultCb

The user defined callback.

user_data

Type: gpointer

The user data to pass in the callback.

The argument can be NULL.
The data is owned by the caller of the method.

Return value

Type: guint

The operation identifier.