mme_set_files_permanent()

Set files as permanent (not prunable) or prunable

Synopsis:

#include <mme/mme.h>

int mme_set_files_permanent( mme_hdl_t *hdl,
                             bool permanent,
                             const char *fidselect );

Arguments:

hdl
An MME connection handle.
permanent
A boolean flag to set the file as permanent “true” (permanent) or “false” (prunable).
fidselect
A SELECT statement to retrieve file or files to be marked.

Library:

mme

Description:

The function mme_set_files_permanent() marks specified media files as permanent (not prunable), or prunable. This feature can be used to ensure that files, such as ring tones, are never pruned from the MME's database. The default setting for files is prunable.

To mark one or more files as either permanent or prunable, call mme_set_files_permanent() with a SELECT statement to select the file or files from the library table, and the permanent argument set to “true” (permanent) or false (prunable), as required. This action sets the permanent field in the library table for the selected file or files. When the MME is pruning its database it will not remove files with the permanent field set to true.

For more information about prune management, see Database pruning in the chapter Configuring Device Support and Media Synchronization of the MME Configuration Guide.

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_resync_mediastore()