- * @param [in] media The handle to media info
- * @param [out] played_time The elapsed time of the content
- *
- * @return 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int media_info_get_played_time(media_info_h media, time_t *played_time) TIZEN_DEPRECATED_API;
-
-/**
- * @brief Gets the media info from the media database.
- *
- * @details This function creates a new media handle from the media database by the given @a media_id.
- * Media info will be created and filled with information.
- *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @remarks You must release @a media using media_tag_destroy().
- *
- * @param[in] media_id The ID of media info
- * @param[out] media The media handle associated with the media ID
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
- * @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB Operation failed
- * @retval #MEDIA_CONTENT_ERROR_DB_BUSY DB Operation busy
- *
- * @pre This function requires opened connection to content service by media_content_connect().
- *
- * @see media_content_connect()
- * @see media_info_destroy()
- */
-int media_info_get_media_from_db(const char *media_id, media_info_h *media);
-
-/**
- * @deprecated Deprecated since 4.0. \n
- * This function does not guarantee independence of the played count value between applications. It is recommended that the value is managed by the application.
- * @brief Increments the played count to content meta handle.
- * @details You can increase the played(opened) count of the content file.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- *
- * @param [in] media The handle to media info
- *
- * @return 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- *
- * @post media_info_update_to_db()
- */
-int media_info_increase_played_count(media_info_h media) TIZEN_DEPRECATED_API;
-
-/**
- * @deprecated Deprecated since 4.0. \n
- * This function does not guarantee independence of the played time value between applications. It is recommended that the value is managed by the application.
- * @brief Sets the played time to content meta handle.
- * @details You can set the latest played(opened) time of the content file. the latest played time to be set the current time on the system.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- *
- * @param [in] media The handle to media info
- *
- * @return 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- *
- * @post media_info_update_to_db()
- */
-int media_info_set_played_time(media_info_h media) TIZEN_DEPRECATED_API;
-
-/**
- * @deprecated Deprecated since 4.0. Redundant, use media_info_move_to_db() instead.
- * @brief Sets the file name including the extension of the content file.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @param[in] media The media info handle
- * @param[in] display_name The file name including the extension of the content file.
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- *
- * @post media_info_update_to_db().
- *
- */
-int media_info_set_display_name(media_info_h media, const char *display_name) TIZEN_DEPRECATED_API;
-
-/**
- * @deprecated Deprecated since 4.0. This data cannot be saved to the file.
- * @brief Sets the description of media info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @param[in] media The media info handle
- * @param[in] description The description of the media info
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- *
- * @post media_info_update_to_db().
- *
- */
-int media_info_set_description(media_info_h media, const char *description) TIZEN_DEPRECATED_API;
-
-/**
- * @deprecated Deprecated since 4.0. This data cannot be saved to the file.
- * @brief Sets the longitude of media info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @param[in] media The media info handle
- * @param[in] longitude The longitude of the media info
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- *
- * @post media_info_update_to_db().
- */
-int media_info_set_longitude(media_info_h media, double longitude) TIZEN_DEPRECATED_API;
-
-/**
- * @deprecated Deprecated since 4.0. This data cannot be saved to the file.
- * @brief Sets the latitude of media info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @param[in] media The media info handle
- * @param[in] latitude The latitude of the media info
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- *
- * @post media_info_update_to_db().
- */
-int media_info_set_latitude(media_info_h media, double latitude) TIZEN_DEPRECATED_API;
-
-/**
- * @deprecated Deprecated since 4.0. This data cannot be saved to the file.
- * @brief Sets the altitude of media info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @param[in] media The media info handle
- * @param[in] altitude The altitude of the media info
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- *
- * @post media_info_update_to_db().
- */
-int media_info_set_altitude(media_info_h media, double altitude) TIZEN_DEPRECATED_API;
-
-/**
- * @brief Sets the weather of media info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @param[in] media The media info handle
- * @param[in] weather The weather of the media info
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- *
- * @post media_info_update_to_db().
- *
- */
-int media_info_set_weather(media_info_h media, const char *weather);
-
-/**
- * @deprecated Deprecated since 4.0. This data cannot be saved to the file.
- * @brief Sets the rating of media info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @param[in] media The media info handle
- * @param[in] rating The rating of the media info
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- *
- * @post media_info_update_to_db().
- */
-int media_info_set_rating(media_info_h media, int rating) TIZEN_DEPRECATED_API;
-
-/**
- * @brief Sets the favorite of media info.
- * @details This function can mark favorite of the media. If set to @c true, this fuction record the time of the change moment. \n
- * So, If you use it in order parameter, you can sort the order of the time was a favorite. \n
- * Or, if you use it in condition parameter, you can get the result of the favorite media.
- *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @param[in] media The media info handle
- * @param[in] favorite Set @c true to set the media info as favorite,
- * otherwise set @c false to not set the media info as favorite
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int media_info_set_favorite(media_info_h media, bool favorite);
-
-/**
- * @deprecated Deprecated since 4.0. This data cannot be saved to the file.
- * @brief Sets the author of media info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @param[in] media The media info handle
- * @param[in] author The author of the media info
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int media_info_set_author(media_info_h media, const char *author) TIZEN_DEPRECATED_API;
-
-/**
- * @brief Sets the provider of media info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @param[in] media The media info handle
- * @param[in] provider The provider of the media info
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int media_info_set_provider(media_info_h media, const char *provider);
-
-/**
- * @deprecated Deprecated since 4.0. Redundant, use media_info_move_to_db() instead.
- * @brief Sets the content name of media info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @param[in] media The media info handle
- * @param[in] content_name The content name of the media info
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- *
- * @post media_info_update_to_db()
- */
-int media_info_set_content_name(media_info_h media, const char *content_name) TIZEN_DEPRECATED_API;
-
-/**
- * @brief Sets the category of media info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @param[in] media The media info handle
- * @param[in] category The category of the media info
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- *
- * @post media_info_update_to_db()
- */
-int media_info_set_category(media_info_h media, const char *category);
-
-/**
- * @brief Sets the location tag of media info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @param[in] media The media info handle
- * @param[in] location_tag The location of the media info
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- *
- * @post media_info_update_to_db()
- */
-int media_info_set_location_tag(media_info_h media, const char *location_tag);
-
-/**
- * @brief Sets the age rating of media info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @param[in] media The media info handle
- * @param[in] age_rating The age rating of the media info
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- *
- * @post media_info_update_to_db()
- */
-int media_info_set_age_rating(media_info_h media, const char *age_rating);
-
-/**
- * @deprecated Deprecated since 4.0. Use media_tag_insert_to_db() instead.
- * @brief Sets the keyword of media info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @param[in] media The media info handle
- * @param[in] keyword The keyword of the media info
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- *
- * @post media_info_update_to_db()
- */
-int media_info_set_keyword(media_info_h media, const char *keyword) TIZEN_DEPRECATED_API;
-
-/**
- * @brief Updates the media info to the media database.
- *
- * @details The function updates the given media info in the media database.
- *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @privlevel public
- * @privilege %http://tizen.org/privilege/content.write
- *
- * @remarks The function should be called after any change in media, to be updated to the media
- * database. For example, after using media_info_set_favorite()
- * for setting the name of the media, the media_info_update_to_db() function should be called so as to update
- * the given media info attributes in the media database.
- *
- * @param[in] media The media info handle
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MEDIA_CONTENT_ERROR_INVALID_OPERATION Invalid operation
- * @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB Operation failed
- * @retval #MEDIA_CONTENT_ERROR_DB_BUSY DB Operation busy
- * @retval #MEDIA_CONTENT_ERROR_NETWORK Network fail
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
- *
- * @pre This function requires opened connection to content service by media_content_connect().
- *
- * @see media_content_connect()
- * @see media_info_set_favorite()
- * @see media_info_set_provider()
- * @see media_info_set_category()
- * @see media_info_set_location_tag()
- * @see media_info_set_age_rating()
- */
-int media_info_update_to_db(media_info_h media);
-
-/**
- * @deprecated Deprecated since 4.0. Use media_content_scan_file() instead.
- * @brief Refreshes the media metadata to the media database.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @privlevel public
- * @privilege %http://tizen.org/privilege/content.write \n
- * %http://tizen.org/privilege/mediastorage \n
- * %http://tizen.org/privilege/externalstorage
- *
- * @remarks You must add privilege http://tizen.org/privilege/content.write. And You add more privilege depending on your choice of contents path. \n
- * If you want to access only internal storage by using this API, you should add privilege http://tizen.org/privilege/mediastorage. \n
- * Or if you want to access only external storage by using this API, you should add privilege http://tizen.org/privilege/externalstorage. \n
- * If you can access both storage, you should add all privilege.
- *
- * @param[in] media_id The ID of the media info
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MEDIA_CONTENT_ERROR_INVALID_OPERATION Invalid operation
- * @retval #MEDIA_CONTENT_ERROR_DB_FAILED DB Operation failed
- * @retval #MEDIA_CONTENT_ERROR_DB_BUSY DB Operation busy
- * @retval #MEDIA_CONTENT_ERROR_NETWORK Network fail
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
- *
- * @pre This function requires opened connection to content service by media_content_connect().
- *
- * @see media_content_connect()
- */
-int media_info_refresh_metadata_to_db(const char *media_id) TIZEN_DEPRECATED_API;
-
-/**
- * @deprecated Deprecated since 4.0. This data cannot be saved to the file.
- * @brief Sets the added time of media info.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- *
- * @param[in] media The media info handle
- * @param[in] added_time The added time of the media info
- *
- * @return @c 0 on success,
- * otherwise a negative error value
- *
- * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- *
- * @post media_info_update_to_db()
- */
-int media_info_set_added_time(media_info_h media, time_t added_time) TIZEN_DEPRECATED_API;
-
-/**
- * @brief Moves the media info to the given destination path in the media database.
- * @details After moving or renaming a file in the filesystem, call this function to update the database.
- *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif