/*
- * Copyright (c) 2015 - 2016 Samsung Electronics Co., Ltd All Rights Reserved
+ * Copyright (c) 2015 - 2017 Samsung Electronics Co., Ltd All Rights Reserved
*
* Licensed under the Apache License, Version 2.0 (the License);
* you may not use this file except in compliance with the License.
#define __TIZEN_APPFW_WIDGET_APP_H__
#include <tizen.h>
-#include <app_control.h>
#include <app_common.h>
#include <bundle.h>
#include <widget_errno.h>
* @brief Gets a widget instance id.
* @since_tizen 2.3.1
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
- * @remark You must not free returned Widget ID
+ * @remark You must not free returned widget instance id
+ * @remark The returned widget instance id is volatile. If the device reboots or the widget's process restarts, it will be changed.\n
+ * So, you should not assume this value is a persistent one.
+ * @remark widget_service_trigger_update(), widget_service_change_period(), widget_service_get_content_of_widget_instance()\n
+ * can be called with returned instance id.
* @param[in] context The context for widget instance
- * @return Widget ID on success,
- * otherwise NULL
+ * @return widget instance id on success,
+ * otherwise NULL
* @exception #WIDGET_ERROR_NOT_SUPPORTED Not supported
* @exception #WIDGET_ERROR_FAULT Unrecoverable error
* @see get_last_result()
+ * @see widget_service_trigger_update()
+ * @see widget_service_change_period()
+ * @see widget_service_get_content_of_widget_instance()
*/
const char *widget_app_get_id(widget_context_h context);
* @return The new widget class object,
* NULL on error
* @exception #WIDGET_ERROR_NONE Successfully added
- * @exception #WIDGET_ERROR_INVALID_PARAMETER Not supported
+ * @exception #WIDGET_ERROR_INVALID_PARAMETER Invalid parameter
* @exception #WIDGET_ERROR_NOT_SUPPORTED Not supported
* @exception #WIDGET_ERROR_OUT_OF_MEMORY Out of memory
* @see get_last_result()
* @return The new widget class object,
* NULL on error
* @exception #WIDGET_ERROR_NONE Successfully added
- * @exception #WIDGET_ERROR_INVALID_PARAMETER Not supported
+ * @exception #WIDGET_ERROR_INVALID_PARAMETER Invalid parameter
* @exception #WIDGET_ERROR_NOT_SUPPORTED Not supported
* @exception #WIDGET_ERROR_OUT_OF_MEMORY Out of memory
* @see get_last_result()