Method

GrlSourcestore_metadata_sync

since: 0.2.0

Declaration [src]

GList*
grl_source_store_metadata_sync (
  GrlSource* source,
  GrlMedia* media,
  GList* keys,
  GrlWriteFlags flags,
  GError** error
)

Description [src]

Update keys values from media in the source. After calling this method, future queries that return this media object shall return this new value for the selected key.

This function is synchronous.

Available since: 0.2.0

Parameters

media

Type: GrlMedia

The GrlMedia object that we want to operate on.

The data is owned by the caller of the method.

keys

Type: A list of None

A list of GrlKeyID whose values we want to change.

The argument can be NULL.

The data is owned by the caller of the method.

flags

Type: GrlWriteFlags

Flags to configure specific behaviors of the operation.

error

Type: GError **

The return location for a recoverable error.

The argument can be NULL.

If the return location is not NULL, then you must initialize it to a NULL GError*.

The argument will be left initialized to NULL by the method if there are no errors.

In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.

Return value

Type: A list of None

a GList of keys that could not be updated, or NULL.

The caller of the method takes ownership of the data container, but not the data inside it.