Add decriptions for extension event api 51/163051/2
authorSeungha Son <seungha.son@samsung.com>
Thu, 7 Dec 2017 05:04:29 +0000 (14:04 +0900)
committerSeungha Son <seungha.son@samsung.com>
Fri, 8 Dec 2017 03:58:44 +0000 (12:58 +0900)
Signed-off-by: Seungha Son <seungha.son@samsung.com>
Change-Id: I485f40a61ed4d591e915006cb7f05034c1324756

include/notification_internal.h

index b56cd6cd547399956f4d423204c045739eb3de4c..a07929dedc8b29a02c9876d1122ea6ad2780de9c 100755 (executable)
@@ -1439,13 +1439,42 @@ int notification_set_extention_data(notification_h noti, const char *key, bundle
 NOTIFICATION_DEPRECATED_API
 int notification_get_extention_data(notification_h noti, const char *key, bundle **value);
 
+/*
+ * @brief Sets the handler for a specific extension event.
+ * @details When some extension event occurs on notification, application launched by app_control_send_launch_request with app_control handle.
+ * @since_tizen 4.0
+ * @param[in] noti The notification handle
+ * @param[in] event_type Event type
+ * @param[in] event_handler App control handle
+ * @return #NOTIFICATION_ERROR_NONE on success,
+ *         otherwise any other value on failure
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #NOTIFICATION_ERROR_IO_ERROR I/O error
+ * @see #notification_event_type_extension_e
+ */
 int notification_set_extension_event_handler(notification_h noti,
                                        notification_event_type_extension_e event,
                                        app_control_h event_handler);
 
+/*
+ * @brief Gets the handler for a specific extension event.
+ * @details When extension event occurs on notification, application launched by app_control_send_launch_request with app_control handle.
+ * @since_tizen 4.0
+ * @param[in] noti The notification handle
+ * @param[in] event_type Event type
+ * @param[out] event_handler App control handle
+ * @return #NOTIFICATION_ERROR_NONE on success,
+ *         otherwise any other value on failure
+ * @retval #NOTIFICATION_ERROR_NONE Success
+ * @retval #NOTIFICATION_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #NOTIFICATION_ERROR_IO_ERROR I/O error
+ * @see #notification_event_type_extension_e
+ */
 int notification_get_extension_event_handler(notification_h noti,
                                        notification_event_type_extension_e event,
                                        app_control_h *event_handler);
+
 /**
  * @}
  */