mme_metadata_image_cache_clear()

Purge images from the image cache

Synopsis:

#include <mme/mme.h>

int mme_metadata_image_cache_clear( mme_hdl_t *hdl,
                                    uint64_t msid );

Arguments:

hdl
An MME connection handle.
msid
The ID of the mediastore for which images must be purged from the image cache. Set to 0 (zero) to clear the entire cache.

Library:

mme

Description:

The function mme_metadata_image_cache_clear() clears from the image cache:

This function can be called at any time; you do not need to create a metadata session before clearing the image cache.


Note: If a client application attempt to clear the cache while an item is being inserted into the cache, mme_metadata_image_cache_clear() returns an EBUSY error. If a client application receives this error, it should attempt to clear the cache again at a later time.

Events

None delivered.

Blocking and validation

This function 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_metadata_create_session(), mme_metadata_free_session(), mme_metadata_getinfo_current(), mme_metadata_getinfo_file(), mme_metadata_getinfo_library(), mme_metadata_image_load(), mme_metadata_image_unload(), mme_metadata_image_url_t, mme_metadata_info_t, mme_metadata_session_t