mme_playlist_create()

Create a new playlist

Synopsis:

#include <mme/playlist.h>

int mme_playlist_create( mme_hdl_t *hdl,
                         uint64_t msid,
                         const char *name,
                         uint64_t *plid );

Arguments:

hdl
An MME connection handle.
msid
The ID for the mediastore from which the playlist will be made. If the mediastore is pruned, the playlist will be deleted. Set the mediastore ID to 0 (zero) to prevent pruning of the mediastore.
name
The name of the new playlist.
plid
The ID for the new playlist.

Library:

mme

Description:

The function mme_playlist_create() creates a new playlist from a mediastore. It adds a playlist entry to the table playlists and the playlist data to the playlistdata table. It does not write to the playlistdata_custom table, or any other *_custom tables; these remain the responsibility of the client application.

Events

None delivered.

Blocking and validation

This function performs no validations, and runs to completion.

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_PLAYLIST_*, mme_playlist_close(), mme_playlist_delete(), mme_playlist_generate_similar(), mme_playlist_hdl_t, mme_playlist_item_get(), mme_playlist_items_count_get(), mme_playlist_open(), mme_playlist_position_set(), mme_playlist_set_statement(), mme_playlist_sync()