mme_metadata_alloc()

Copy a metadata handle

Synopsis:

#include <mme/explore.h>

mme_metadata_hdl_t *mme_metadata_alloc(
                        const mme_metadata_hdl_t *metadata );

Arguments:

metadata
A pointer to the metadata to copy.

Library:

mme

Description:

The function mme_metadata_alloc() makes and returns a malloced copy of a specified metadata handle structure mme_metadata_hdl_t, making it easier for users of the MME's explorer API to copy retrieved items.


Note: The client application must deallocate the returned value from mme_metadata_alloc() by using free().

For more information about managing metadata handles, see Managing explorer structures and metadata handles in the chapter Metadata and Artwork in the MME Developer's Guide.

Events

None delivered.

Blocking and validation

This function performs no validations and doesn't block.

Returns

Returns:

A copied metadata handle structure.
Success.
0
An error occurred (errno is set), or the metadata handle received is NULL.

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

METADATA_*, mme_metadata_extract_data(), mme_metadata_extract_string(), mme_metadata_extract_unsigned(), mme_metadata_hdl_t, mme_ms_metadata_done(), mme_ms_metadata_get()