Set values in specified table column
#include <mme/mme.h>
int mme_lib_column_set( mme_hdl_t *hdl,
uint64_t msid,
const char *column,
int value );
- hdl
- An MME connection handle.
- msid
- The ID of the mediastore for which a value needs to be changed in the library table.
- column
- The name of the library table column that needs to be changed.
- value
- The new value for the entries for the specified mediastore in the specified column.
mme
The function mme_lib_column_set() inserts a value into the entries for a mediastore in the library table (or adjunct tables). It can be used to perform actions such as clearing the library table accurate fields for the specified mediastore.
This function can only be used to update entries in the columns listed below, and it validates that the character string referenced by column specifies one of these columns:
- accurate
- last_played
- fullplay_count
- playable
- permanent
- copied_fid
 |
- When mme_lib_column_set() completes execution it returns the number of rows for the specified mediastore that now have the new value. In other words, the function returns the number of rows for the specified mediastore that are now set to the new value.
- If prior to the call to mme_lib_column_set() some rows were already set to the required value, the return value may differ from the number of rows actually updated.
- Only rows for the specified mediastore are included in the return value. Rows for other mediastores are not counted.
|
None delivered.
This function validates the column name; it executes to completion.
- ≥0
- Success: the number of table rows for the specified mediastore, with the new value updated. See “Update behavior” above.
- -1
- An error occurred (errno is set).
QNX Neutrino
Safety: | |
Interrupt handler |
No |
Signal handler |
No |
Thread |
Yes |
mme_directed_sync_cancel(),
mme_resync_mediastore(),
mme_setpriorityfolder(),
mme_sync_cancel(),
mme_sync_directed(),
mme_sync_file(),
mme_sync_get_msid_status(),
mme_sync_get_status()