[ACR-1098] Deprecate APIs for product

[platform/core/api/media-content.git] / include / media_tag.h

diff --git a/include/media_tag.h b/include/media_tag.h
index 59fc3c4..f61d23c 100755 (executable)
--- a/include/media_tag.h
+++ b/include/media_tag.h
@@ -51,7 +51,7 @@ extern "C" {
  * @param[in]  tag_name The tag name to be inserted
  * @param[out] tag      The created handle to the media tag
  *
- * @return @c 0 on success, 
+ * @return @c 0 on success,
  *         otherwise a negative error value
  *
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
@@ -80,7 +80,7 @@ int media_tag_insert_to_db(const char *tag_name, media_tag_h *tag);
  *
  * @param[in] tag_id The ID of media tag
  *
- * @return @c 0 on success, 
+ * @return @c 0 on success,
  *         otherwise a negative error value
  *
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
@@ -105,7 +105,7 @@ int media_tag_delete_from_db(int tag_id);
  * @param[in]  filter    The handle to the filter
  * @param[out] tag_count The count of the media tag
  *
- * @return @c 0 on success, 
+ * @return @c 0 on success,
  *         otherwise a negative error value
  *
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
@@ -132,7 +132,7 @@ int media_tag_get_tag_count_from_db(filter_h filter, int *tag_count);
  * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  *
- * @return @c 0 on success, 
+ * @return @c 0 on success,
  *         otherwise a negative error value
  *
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
@@ -149,7 +149,7 @@ int media_tag_get_tag_count_from_db(filter_h filter, int *tag_count);
  * @see #media_tag_cb
  * @see media_filter_create()
  */
-int media_tag_foreach_tag_from_db (filter_h filter, media_tag_cb callback, void *user_data);
+int media_tag_foreach_tag_from_db(filter_h filter, media_tag_cb callback, void *user_data);
 
 /**
  * @brief Gets the number of media files for the passed @a filter in the given @a tag from the media database.
@@ -159,7 +159,7 @@ int media_tag_foreach_tag_from_db (filter_h filter, media_tag_cb callback, void
  * @param[in]  filter      The handle to the media filter
  * @param[out] media_count The count of media items
  *
- * @return @c 0 on success, 
+ * @return @c 0 on success,
  *         otherwise a negative error value
  *
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
@@ -172,7 +172,7 @@ int media_tag_foreach_tag_from_db (filter_h filter, media_tag_cb callback, void
  *
  * @see media_content_connect()
  */
-int media_tag_get_media_count_from_db (int tag_id, filter_h filter, int *media_count);
+int media_tag_get_media_count_from_db(int tag_id, filter_h filter, int *media_count);
 
 /**
  * @brief Iterates through media items for a given tag from the media database.
@@ -187,7 +187,7 @@ int media_tag_get_media_count_from_db (int tag_id, filter_h filter, int *media_c
  * @param[in] callback  The callback function to be invoked
  * @param[in] user_data The user data to be passed to the callback function
  *
- * @return @c 0 on success, 
+ * @return @c 0 on success,
  *         otherwise a negative error value
  *
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
@@ -220,13 +220,12 @@ int media_tag_foreach_media_from_db(int tag_id, filter_h filter, media_info_cb c
  * @param[out] dst The destination handle to the media tag
  * @param[in]  src The source handle to the media tag
  *
- * @return @c 0 on success, 
+ * @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
  *
  * @see media_tag_destroy()
  */
@@ -241,12 +240,11 @@ int media_tag_clone(media_tag_h *dst, media_tag_h src);
  *
  * @param[in] tag The media tag handle
  *
- * @return @c 0 on success, 
+ * @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_PERMISSION_DENIED Permission denied
  *
  * @pre A copy of the media tag handle created by calling media_tag_clone() or media_tag_insert_to_db().
  *
@@ -262,12 +260,11 @@ int media_tag_destroy(media_tag_h tag);
  * @param[in]  tag     The media tag handle
  * @param[out] tag_id  The ID of the media tag
  *
- * @return @c 0 on success, 
+ * @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_PERMISSION_DENIED Permission denied
  */
 int media_tag_get_tag_id(media_tag_h tag, int *tag_id);
 
@@ -280,13 +277,12 @@ int media_tag_get_tag_id(media_tag_h tag, int *tag_id);
  * @param[in]  tag      The media tag handle
  * @param[out] tag_name The name of the tag
  *
- * @return @c 0 on success, 
+ * @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_PERMISSION_DENIED Permission denied
  */
 int media_tag_get_name(media_tag_h tag, char **tag_name);
 
@@ -303,7 +299,7 @@ int media_tag_get_name(media_tag_h tag, char **tag_name);
  * @param[in]  tag_id The ID of the media tag
  * @param[out] tag    The media tag handle associated with the tag ID
  *
- * @return @c 0 on success, 
+ * @return @c 0 on success,
  *         otherwise a negative error value
  *
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
@@ -327,13 +323,12 @@ int media_tag_get_tag_from_db(int tag_id, media_tag_h *tag);
  * @param[in] tag      The media tag handle
  * @param[in] media_id The ID to the media info which is added
  *
- * @return @c 0 on success, 
+ * @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_PERMISSION_DENIED Permission denied
  *
  * @pre  This function requires opened connection to content service by media_content_connect().
  * @post media_tag_update_to_db()
@@ -350,13 +345,12 @@ int media_tag_add_media(media_tag_h tag, const char *media_id);
  * @param[in] tag      The media tag handle
  * @param[in] media_id The ID to the media info which is removed
  *
- * @return @c 0 on success, 
+ * @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_PERMISSION_DENIED Permission denied
  *
  * @pre  This function requires opened connection to content service by media_content_connect().
  * @post media_tag_update_to_db()
@@ -373,17 +367,16 @@ int media_tag_remove_media(media_tag_h tag, const char *media_id);
  * @param[in] tag      The media tag handle
  * @param[in] tag_name The name of the media tag
  *
- * @return @c 0 on success, 
+ * @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_PERMISSION_DENIED Permission denied
  *
  * @post media_tag_update_to_db()
  */
-int media_tag_set_name(media_tag_h tag, char *tag_name);
+int media_tag_set_name(media_tag_h tag, const char *tag_name);
 
 /**
  * @brief Updates the media tag to the media database.
@@ -399,7 +392,7 @@ int media_tag_set_name(media_tag_h tag, char *tag_name);
  *
  * @param[in] tag The media tag handle
  *
- * @return @c 0 on success, 
+ * @return @c 0 on success,
  *         otherwise a negative error value
  *
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful