Update package version to 0.1.80

[platform/core/uifw/capi-ui-sticker.git] / include / sticker_data.h

diff --git a/include/sticker_data.h b/include/sticker_data.h
index 088c386..4f75071 100644 (file)
--- a/include/sticker_data.h
+++ b/include/sticker_data.h
@@ -119,6 +119,23 @@ int sticker_data_destroy(sticker_data_h data_handle);
 int sticker_data_clone(sticker_data_h origin_handle, sticker_data_h *target_handle);
 
 /**
+ * @brief Gets the sticker data handle for the given URI.
+ * @since_tizen 5.5
+ * @remarks If the function succeeds, @a data_handle must be released with sticker_data_destroy().
+ * @param[in] uri The URI of the sticker data handle
+ * @param[out] data_handle The sticker data handle for the given sticker URI
+ * @return 0 on success, otherwise a negative error value
+ * @retval #STICKER_ERROR_NONE Successful
+ * @retval #STICKER_ERROR_NOT_SUPPORTED Not supported
+ * @retval #STICKER_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #STICKER_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #STICKER_ERROR_OPERATION_FAILED Operation failed
+ * @retval #STICKER_ERROR_NO_SUCH_FILE A sticker with given @a uri does not exist
+ * @see sticker_data_destroy()
+ */
+int sticker_data_get_handle(const char* uri, sticker_data_h *data_handle);
+
+/**
  * @brief Gets the name of the sticker provider application from sticker data handle.
  * @since_tizen 5.5
  * @remarks @a app_id must be released using free().
@@ -224,7 +241,7 @@ int sticker_data_remove_keyword(sticker_data_h data_handle, const char *keyword)
  * @retval #STICKER_ERROR_NONE Successful
  * @retval #STICKER_ERROR_NOT_SUPPORTED Not supported
  * @retval #STICKER_ERROR_INVALID_PARAMETER Invalid parameter
- * @see sticker_data_get_group()
+ * @see sticker_data_get_group_name()
  */
 int sticker_data_set_group_name(sticker_data_h data_handle, const char *group);
 
@@ -239,7 +256,7 @@ int sticker_data_set_group_name(sticker_data_h data_handle, const char *group);
  * @retval #STICKER_ERROR_NOT_SUPPORTED Not supported
  * @retval #STICKER_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #STICKER_ERROR_NO_DATA No data available
- * @see sticker_data_set_group()
+ * @see sticker_data_set_group_name()
  */
 int sticker_data_get_group_name(sticker_data_h data_handle, char **group);