mme_metadata_create_session()

Create a new metatdata session

Synopsis:

#include <mme/mme.h>

int mme_metadata_create_session( mme_hdl_t *hdl,
                                 mme_metadata_session_t **session );

Arguments:

hdl
An MME connection handle.
session
A pointer to the location with the metadata session structure.

Library:

mme

Description:

The function mme_metadata_create_session() creates a new metata session. Creating a metadata session guarantees that the images loaded and the metadata retrieved remain valid until the session is ended by a call to mme_metadata_free_session().

A client application may have multiple metadata sessions open at the same time, only limited by system resources. Because every metadata session consumes system resources, the client application should end a metadata session when the data requested in that session is no longer needed.

Events

None delivered.

Blocking and validation

This function doesn't block.

Returns:

EOK and a valid pointer to an mme_metadata_session_t data structure.
Success.
-1
An error occurred (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

mme_metadata_free_session(), mme_metadata_getinfo_current(), mme_metadata_getinfo_file(), mme_metadata_getinfo_library(), mme_metadata_image_cache_clear(), mme_metadata_image_load(), mme_metadata_image_unload(), mme_metadata_image_url_t, mme_metadata_info_t, mme_metadata_session_t