mme_ms_metadata_get()

Get metadata from a file

Synopsis:

#include <mme/metadata.h>

mme_metadata_hdl_t *mme_ms_metadata_get(
                       mme_hdl_t *hdl,
                       uint64_t *msid,
                       const char *path,
                       const char *types,
                       uint32_t flags );

Arguments:

hdl
The MME connection handle.
msid
The ID of the mediastore with the file whose metadata is required.
path
The path and filename (not including the mediastore mountpath) of the file whose metadata is required.
types
A pointer to a string containing a comma-separated list of metadata types to retrieve. May not be NULL. See METADATA_*.
flags
For future use.

Library:

metadata

Description:

The function mme_metadata_get() gets metadata for a file and places it in the metadata handle mme_metadata_hdl_t. The type of metadata retrieved is defined by the METADATA_FORMAT_* enumerated values.

Events

None delivered.

Blocking and validation

This function performs no validations and doesn't block.

Returns:

Data in the character string, or NULL if no data is found (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

METADATA_*, mme_metadata_alloc(), mme_metadata_extract_data(), mme_metadata_extract_string(), mme_metadata_hdl_t, mme_ms_metadata_done()