Merge branch 'tizen_6.0' into tizen

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

diff --git a/include/sticker_data.h b/include/sticker_data.h
index 2a59af1..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().