mme_metadata_set()

Set the metadata for a file

Synopsis:

#include <mme/mme.h>

int mme_metadata_set( mme_hdl_t *hdl,
                      uint64_t fid,
                      mm_metadata_t *metadata,
                      uint64_t flags );

Arguments:

hdl
An MME connection handle.
fid
The file ID of the file whose metadata you want to set.
metadata
A pointer to the structure that carries the file metadata. For more information, see mm_metadata_t.
flags
A flag to define the behavior of the call. For future use.

Library:

mme

Description:

The function mme_metadata_set() sets the metadata in the MME database for a specified file. The client application can use this function with an HMI to allow the end-user to change the metadata in the MME database for copied and ripped media. It sets the metadata in the database, and can be used to correct and complete metadata that was incorrectly or incompletely entered when the file was copied or ripped.

To set the metadata for a file:

  1. Complete the structure mm_metadata_t with the file metadata.
  2. Call mme_metadata_set(), specifying the file ID.

Events

None delivered.

Blocking and validation

This function performs no validations, and doesn't block.

Returns:

0
Success.
-1
An error occurred (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

mme_mediacopier_add(), mme_mediacopier_get_mode(), mme_mediacopier_set_mode(),