Change deprecated to 8.0 41/299941/1 accepted/tizen_8.0_unified tizen_8.0 accepted/tizen/8.0/unified/20231014.183208 tizen_8.0_m2_release
authorKrishna Kant Jaju <krishna.jaju@samsung.com>
Tue, 26 Sep 2023 07:05:40 +0000 (12:35 +0530)
committerPriya Kohli <priya.kohli@samsung.com>
Thu, 12 Oct 2023 08:56:48 +0000 (08:56 +0000)
Change-Id: If097491b07280aa407e04c83e20ee48b4650df61
Signed-off-by: Krishna Kant Jaju <krishna.jaju@samsung.com>
(cherry picked from commit c382150d8811d0dfdc9aa6502c2299f329eea610)

doc/messages_doc.h
include/messages.h
include/messages_error.h
include/messages_types.h

index 755d37cf08ab32ebf7d2173e94a50d1be1f72ba6..53a632be767d2b080f2f32f0639f8e379bd403bb 100755 (executable)
@@ -21,7 +21,7 @@
 
 /**
  * @ingroup CAPI_MESSAGING_FRAMEWORK
- * @defgroup CAPI_MESSAGING_MESSAGES_MODULE Messages
+ * @defgroup CAPI_MESSAGING_MESSAGES_MODULE Messages (Deprecated)
  * @addtogroup CAPI_MESSAGING_MESSAGES_MODULE
  * @brief The @ref CAPI_MESSAGING_MESSAGES_MODULE API provides functions to create, set properties, and send a SMS/MMS message.
  * @section CAPI_MESSAGING_MESSAGES_MODULE_HEADER Required Header
@@ -52,7 +52,7 @@
 
 /**
  * @ingroup CAPI_MESSAGING_MESSAGES_MODULE
- * @defgroup CAPI_MESSAGING_MESSAGES_MMS_MODULE MMS
+ * @defgroup CAPI_MESSAGING_MESSAGES_MMS_MODULE MMS (Deprecated)
  * @addtogroup CAPI_MESSAGING_MESSAGES_MMS_MODULE
  * @brief The MMS API provides functions to manage attachments and subject of the MMS message.
  * @section CAPI_MESSAGING_MESSAGES_MMS_MODULE_HEADER Required Header
@@ -79,7 +79,7 @@
 
 /**
  * @ingroup CAPI_MESSAGING_MESSAGES_MODULE
- * @defgroup CAPI_MESSAGING_MESSAGES_PUSH_MODULE WAP Push
+ * @defgroup CAPI_MESSAGING_MESSAGES_PUSH_MODULE WAP Push (Deprecated)
  * @addtogroup CAPI_MESSAGING_MESSAGES_PUSH_MODULE
  * @brief The WAP PUSH API provides functions to add/remove incoming callback for WAP Push messages and register current application to push server.
  * @section CAPI_MESSAGING_MESSAGES_PUSH_MODULE_HEADER Required Header
index 4995ebc57041e456f96174a36b3e33a9058de80f..b8e71408b06ae6322d236483ae9e840f32022d34 100644 (file)
@@ -19,6 +19,7 @@
 #define __TIZEN_MESSAGING_H__
 
 
+#include <tizen.h>
 #include <time.h>
 #include <messages_types.h>
 #include <messages_error.h>
@@ -43,6 +44,7 @@ extern "C"
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Opens a handle for the messaging service.
  * @since_tizen 2.3
  * @privlevel public
@@ -59,10 +61,11 @@ extern "C"
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see        messages_close_service()
  */
-int messages_open_service(messages_service_h *service);
+int messages_open_service(messages_service_h *service) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Closes a handle for the messaging service.
  * @since_tizen 2.3
  * @privlevel public
@@ -77,10 +80,11 @@ int messages_open_service(messages_service_h *service);
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see        messages_open_service()
  */
-int messages_close_service(messages_service_h service);
+int messages_close_service(messages_service_h service) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Creates a message handle.
  * @since_tizen 2.3
  * @remarks You must release @a msg using messages_destroy_message().
@@ -95,10 +99,11 @@ int messages_close_service(messages_service_h service);
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see        messages_destroy_message()
  */
-int messages_create_message(messages_message_type_e type, messages_message_h *msg);
+int messages_create_message(messages_message_type_e type, messages_message_h *msg) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Destroys a message handle and releases all its resources.
  * @since_tizen 2.3
  * @param[in] msg The message handle to destroy
@@ -109,10 +114,11 @@ int messages_create_message(messages_message_type_e type, messages_message_h *ms
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see        messages_create_message()
  */
-int messages_destroy_message(messages_message_h msg);
+int messages_destroy_message(messages_message_h msg) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Adds the message to message database.
  * @since_tizen 3.0
  * @privlevel public
@@ -129,10 +135,11 @@ int messages_destroy_message(messages_message_h msg);
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_create_message()
  */
-int messages_add_message(messages_service_h service, messages_message_h msg, int *msg_id);
+int messages_add_message(messages_service_h service, messages_message_h msg, int *msg_id) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Gets the message ID of the message.
  * @since_tizen 2.3
  * @param[in] msg The message handle
@@ -145,10 +152,11 @@ int messages_add_message(messages_service_h service, messages_message_h msg, int
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_search_message_by_id()
  */
-int messages_get_message_id(messages_message_h msg, int *msg_id);
+int messages_get_message_id(messages_message_h msg, int *msg_id) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Sets the SIM ID of the sending message.
  * @since_tizen 2.3
  * @param[in] msg The message handle
@@ -161,10 +169,11 @@ int messages_get_message_id(messages_message_h msg, int *msg_id);
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_get_sim_id()
  */
-int messages_set_sim_id(messages_message_h msg, int sim_id);
+int messages_set_sim_id(messages_message_h msg, int sim_id) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Gets the SIM ID of the message.
  * @since_tizen 2.3
  * @param[in] msg The message handle
@@ -177,10 +186,11 @@ int messages_set_sim_id(messages_message_h msg, int sim_id);
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_set_sim_id()
  */
-int messages_get_sim_id(messages_message_h msg, int *sim_id);
+int messages_get_sim_id(messages_message_h msg, int *sim_id) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Sets the message box type of the message.
  * @since_tizen 3.0
  * @param[in] msg The message handle
@@ -191,10 +201,11 @@ int messages_get_sim_id(messages_message_h msg, int *sim_id);
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
-int messages_set_mbox_type(messages_message_h msg, messages_message_box_e mbox);
+int messages_set_mbox_type(messages_message_h msg, messages_message_box_e mbox) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Gets the message box type of the message.
  * @since_tizen 2.3
  * @param[in] msg The message handle
@@ -205,10 +216,11 @@ int messages_set_mbox_type(messages_message_h msg, messages_message_box_e mbox);
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
-int messages_get_mbox_type(messages_message_h msg, messages_message_box_e *mbox);
+int messages_get_mbox_type(messages_message_h msg, messages_message_box_e *mbox) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Gets the destination port of the message.
  * @since_tizen 2.3
  * @param[in] msg The message handle
@@ -220,10 +232,11 @@ int messages_get_mbox_type(messages_message_h msg, messages_message_box_e *mbox)
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_add_sms_listening_port()
  */
-int messages_get_message_port(messages_message_h msg, int *port);
+int messages_get_message_port(messages_message_h msg, int *port) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Gets the type of the message.
  * @since_tizen 2.3
  * @param[in] msg The message handle
@@ -234,10 +247,11 @@ int messages_get_message_port(messages_message_h msg, int *port);
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
-int messages_get_message_type(messages_message_h msg, messages_message_type_e *type);
+int messages_get_message_type(messages_message_h msg, messages_message_type_e *type) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Adds an recipient's address(phone number) to the message.
  * @details The maximum number of recipients per message is 10.
  * @since_tizen 2.3
@@ -253,10 +267,11 @@ int messages_get_message_type(messages_message_h msg, messages_message_type_e *t
  * @see        messages_get_address()
  * @see        messages_remove_all_addresses()
  */
-int messages_add_address(messages_message_h msg, const char *address, messages_recipient_type_e type);
+int messages_add_address(messages_message_h msg, const char *address, messages_recipient_type_e type) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Gets the total number of recipients in the message.
  * @since_tizen 2.3
  * @param[in] msg The message handle
@@ -269,10 +284,11 @@ int messages_add_address(messages_message_h msg, const char *address, messages_r
  * @see        messages_add_address()
  * @see        messages_remove_all_addresses()
  */
-int messages_get_address_count(messages_message_h msg, int *count);
+int messages_get_address_count(messages_message_h msg, int *count) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Gets a recipient's address with specified index.
  * @since_tizen 2.3
  * @remarks You must release @a address using free().
@@ -289,10 +305,11 @@ int messages_get_address_count(messages_message_h msg, int *count);
  * @see        messages_add_address()
  * @see        messages_remove_all_addresses()
  */
-int messages_get_address(messages_message_h msg, int index, char **address, messages_recipient_type_e *type);
+int messages_get_address(messages_message_h msg, int index, char **address, messages_recipient_type_e *type) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Removes all recipients in the message.
  * @since_tizen 2.3
  * @param[in] msg The message handle
@@ -304,10 +321,11 @@ int messages_get_address(messages_message_h msg, int index, char **address, mess
  * @see        messages_add_address()
  * @see        messages_get_address()
  */
-int messages_remove_all_addresses(messages_message_h msg);
+int messages_remove_all_addresses(messages_message_h msg) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Sets the text of the message.
  * @since_tizen 2.3
  * @param[in] msg The message handle
@@ -321,10 +339,11 @@ int messages_remove_all_addresses(messages_message_h msg);
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see        messages_get_text()
  */
-int messages_set_text(messages_message_h msg, const char *text);
+int messages_set_text(messages_message_h msg, const char *text) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Gets the text of the message.
  * @since_tizen 2.3
  * @remarks You must release @a text using free().
@@ -338,10 +357,11 @@ int messages_set_text(messages_message_h msg, const char *text);
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see        messages_set_text()
  */
-int messages_get_text(messages_message_h msg, char **text);
+int messages_get_text(messages_message_h msg, char **text) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Sets the time of the message.
  * @since_tizen 3.0
  * @param[in] msg The message handle
@@ -352,10 +372,11 @@ int messages_get_text(messages_message_h msg, char **text);
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
-int messages_set_time(messages_message_h msg, time_t time);
+int messages_set_time(messages_message_h msg, time_t time) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Gets the time of the message.
  * @since_tizen 2.3
  * @param[in] msg The message handle
@@ -366,10 +387,11 @@ int messages_set_time(messages_message_h msg, time_t time);
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
-int messages_get_time(messages_message_h msg, time_t *time);
+int messages_get_time(messages_message_h msg, time_t *time) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Sends the message to all recipients.
  * @since_tizen 2.3
  * @privlevel public
@@ -390,10 +412,11 @@ int messages_get_time(messages_message_h msg, time_t *time);
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_sent_cb()
  */
-int messages_send_message(messages_service_h service, messages_message_h msg, bool save_to_sentbox, messages_sent_cb callback, void *user_data);
+int messages_send_message(messages_service_h service, messages_message_h msg, bool save_to_sentbox, messages_sent_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Gets the message count in the specific message box.
  * @since_tizen 2.3
  * @privlevel public
@@ -411,11 +434,12 @@ int messages_send_message(messages_service_h service, messages_message_h msg, bo
  * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
-int messages_get_message_count(messages_service_h service, messages_message_box_e mbox, messages_message_type_e type, int *count);
+int messages_get_message_count(messages_service_h service, messages_message_box_e mbox, messages_message_type_e type, int *count) TIZEN_DEPRECATED_API;
 
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Searches for messages.
  * @since_tizen 2.3
  * @privlevel public
@@ -450,10 +474,11 @@ int messages_search_message(messages_service_h service,
                                                        messages_message_type_e type,
                                                        const char *keyword, const char *address,
                                                        int offset, int limit,
-                                                       messages_message_h **message_array, int *length, int *total);
+                                                       messages_message_h **message_array, int *length, int *total) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Searches a message with the given message ID.
  * @since_tizen 2.3
  * @privlevel public
@@ -471,10 +496,11 @@ int messages_search_message(messages_service_h service,
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_get_message_id()
  */
-int messages_search_message_by_id(messages_service_h service, int msg_id, messages_message_h *msg);
+int messages_search_message_by_id(messages_service_h service, int msg_id, messages_message_h *msg) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Frees the message array.
  * @since_tizen 2.3
  * @param[in] message_array The array of the message handle
@@ -485,10 +511,11 @@ int messages_search_message_by_id(messages_service_h service, int msg_id, messag
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  * @see messages_search_message()
  */
-int messages_free_message_array(messages_message_h *message_array);
+int messages_free_message_array(messages_message_h *message_array) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Retrieves the searched messages by invoking the given callback function iteratively.
  * @since_tizen 2.3
  * @privlevel public
@@ -520,10 +547,11 @@ int messages_foreach_message(messages_service_h service,
                                                         messages_message_type_e type,
                                                         const char *keyword, const char *address,
                                                         int offset, int limit,
-                                                        messages_search_cb callback, void *user_data);
+                                                        messages_search_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Registers a callback to be invoked when an incoming message is received.
  * @since_tizen 2.3
  * @privlevel public
@@ -542,10 +570,11 @@ int messages_foreach_message(messages_service_h service,
  * @see messages_unset_message_incoming_cb()
  * @see messages_incoming_cb()
  */
-int messages_set_message_incoming_cb(messages_service_h service, messages_incoming_cb callback, void *user_data);
+int messages_set_message_incoming_cb(messages_service_h service, messages_incoming_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Unregisters the callback function.
  * @since_tizen 2.3
  * @privlevel public
@@ -560,10 +589,11 @@ int messages_set_message_incoming_cb(messages_service_h service, messages_incomi
  * @see messages_set_message_incoming_cb()
  * @see messages_incoming_cb()
  */
-int messages_unset_message_incoming_cb(messages_service_h service);
+int messages_unset_message_incoming_cb(messages_service_h service) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Adds an additional listening port for the incoming SMS messages.
  * @since_tizen 2.3
  * @privlevel public
@@ -579,7 +609,7 @@ int messages_unset_message_incoming_cb(messages_service_h service);
  * @see messages_set_message_incoming_cb()
  * @see messages_get_message_port()
  */
-int messages_add_sms_listening_port(messages_service_h service, int port);
+int messages_add_sms_listening_port(messages_service_h service, int port) TIZEN_DEPRECATED_API;
 
 
 /**
@@ -589,6 +619,7 @@ int messages_add_sms_listening_port(messages_service_h service, int port);
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Sets the subject of the message.
  * @since_tizen 2.3
  * @param[in] msg The message handle
@@ -602,10 +633,11 @@ int messages_add_sms_listening_port(messages_service_h service, int port);
  * @pre @a msg is created as a #MESSAGES_TYPE_MMS.
  * @see        messages_mms_get_subject()
  */
-int messages_mms_set_subject(messages_message_h msg, const char *subject);
+int messages_mms_set_subject(messages_message_h msg, const char *subject) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Gets the subject of the message.
  * @since_tizen 2.3
  * @remarks You must release @a subject using free().
@@ -620,10 +652,11 @@ int messages_mms_set_subject(messages_message_h msg, const char *subject);
  * @pre @a msg is created as a #MESSAGES_TYPE_MMS.
  * @see        messages_mms_set_subject()
  */
-int messages_mms_get_subject(messages_message_h msg, char **subject);
+int messages_mms_get_subject(messages_message_h msg, char **subject) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Adds the attachment to the MMS message.
  * @since_tizen 2.3
  * @param[in] msg The message handle
@@ -641,10 +674,11 @@ int messages_mms_get_subject(messages_message_h msg, char **subject);
  * @see        messages_mms_get_attachment_count()
  * @see        messages_mms_remove_all_attachments()
  */
-int messages_mms_add_attachment(messages_message_h msg, messages_media_type_e type, const char *path);
+int messages_mms_add_attachment(messages_message_h msg, messages_media_type_e type, const char *path) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Gets the file path of the attachment with the specified index.
  * @since_tizen 2.3
  * @remarks You must release @a path using free().
@@ -663,10 +697,11 @@ int messages_mms_add_attachment(messages_message_h msg, messages_media_type_e ty
  * @see        messages_mms_get_attachment_count()
  * @see        messages_mms_remove_all_attachments()
  */
-int messages_mms_get_attachment(messages_message_h msg, int index, messages_media_type_e *type, char **path);
+int messages_mms_get_attachment(messages_message_h msg, int index, messages_media_type_e *type, char **path) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Gets the attachment with the specified index.
  * @since_tizen 2.3
  * @param[in] msg The message handle
@@ -681,10 +716,11 @@ int messages_mms_get_attachment(messages_message_h msg, int index, messages_medi
  * @see        messages_mms_get_attachment()
  * @see        messages_mms_remove_all_attachments()
  */
-int messages_mms_get_attachment_count(messages_message_h msg, int *count);
+int messages_mms_get_attachment_count(messages_message_h msg, int *count) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Removes all attachments to the MMS message.
  * @since_tizen 2.3
  * @param[in] msg The message handle
@@ -698,7 +734,7 @@ int messages_mms_get_attachment_count(messages_message_h msg, int *count);
  * @see        messages_mms_get_attachment()
  * @see        messages_mms_get_attachment_count()
  */
-int messages_mms_remove_all_attachments(messages_message_h msg);
+int messages_mms_remove_all_attachments(messages_message_h msg) TIZEN_DEPRECATED_API;
 
 
 /**
@@ -713,6 +749,7 @@ int messages_mms_remove_all_attachments(messages_message_h msg);
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Registers a callback to be invoked when an WAP Push message is received.
  * @since_tizen 2.3
  * @privlevel public
@@ -729,10 +766,11 @@ int messages_mms_remove_all_attachments(messages_message_h msg);
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
 int messages_push_add_incoming_cb(messages_service_h service, const char *app_id,
-                                         messages_push_incoming_cb callback, void *user_data);
+                                         messages_push_incoming_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Unregisters the WAP push incoming callback function.
  * @since_tizen 2.3
  * @param[in] service The message service handle
@@ -743,10 +781,11 @@ int messages_push_add_incoming_cb(messages_service_h service, const char *app_id
  * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
-int messages_push_remove_incoming_cb(messages_service_h service, const char *app_id);
+int messages_push_remove_incoming_cb(messages_service_h service, const char *app_id) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Registers an application to the mapping table of the WAP Push service.
  * @since_tizen 2.3
  * @privlevel public
@@ -761,10 +800,11 @@ int messages_push_remove_incoming_cb(messages_service_h service, const char *app
  * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
-int messages_push_register(messages_service_h service, const char *content_type, const char *app_id);
+int messages_push_register(messages_service_h service, const char *content_type, const char *app_id) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief De-registers an application from the mapping table of the WAP Push service.
  * @since_tizen 2.3
  * @privlevel public
@@ -779,10 +819,11 @@ int messages_push_register(messages_service_h service, const char *content_type,
  * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
-int messages_push_deregister(messages_service_h service, const char *content_type, const char *app_id);
+int messages_push_deregister(messages_service_h service, const char *content_type, const char *app_id) TIZEN_DEPRECATED_API;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Re-registers an application to the mapping table of the WAP Push service.
  * @since_tizen 2.3
  * @privlevel public
@@ -802,7 +843,7 @@ int messages_push_deregister(messages_service_h service, const char *content_typ
  * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
  */
 int messages_push_reregister(messages_service_h service, const char *content_type, const char *app_id,
-                                                        const char *dst_content_type, const char *dst_app_id);
+                                                        const char *dst_content_type, const char *dst_app_id) TIZEN_DEPRECATED_API;
 
 
 /**
index c0fcf01371ebe3fc9febef4c6ce051d2e0ed02b2..952b4866111a29a38a1b2ecde54784ae1e26e929 100644 (file)
@@ -35,6 +35,7 @@ extern "C"
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Enumeration for Messaging of error code.
  */
 typedef enum {
index bd06b04b0d1461fbcacdd27ead8eca68e83829ef..26b75bdc8de2e0fabb6a3314e33eaa7cc01f17e8 100644 (file)
@@ -19,6 +19,7 @@
 #define __TIZEN_MESSAGING_TYPES_H__
 
 
+#include <tizen.h>
 #include <stdbool.h>
 
 
@@ -35,6 +36,7 @@ extern "C"
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief The messaging service handle.
  * @since_tizen 2.3
  */
@@ -42,6 +44,7 @@ typedef struct messages_service_s *messages_service_h;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief The message handle.
  * @since_tizen 2.3
  */
@@ -49,6 +52,7 @@ typedef struct messages_message_s *messages_message_h;
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Enumeration for the message box type.
  * @since_tizen 2.3
  */
@@ -62,6 +66,7 @@ typedef enum {
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Enumeration for the message type.
  * @since_tizen 2.3
  */
@@ -77,6 +82,7 @@ typedef enum {
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Enumeration for the attachment type for MMS messaging.
  * @since_tizen 2.3
  */
@@ -89,6 +95,7 @@ typedef enum {
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Enumeration for the recipient type of a message.
  * @since_tizen 2.3
  */
@@ -101,6 +108,7 @@ typedef enum {
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Enumeration for the result of sending a message.
  * @since_tizen 2.3
  */
@@ -111,6 +119,7 @@ typedef enum {
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Enumeration for the SIM index of a message.
  * @since_tizen 2.3
  */
@@ -122,6 +131,7 @@ typedef enum {
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Called when the process of sending a message to all recipients finishes.
  * @since_tizen 2.3
  * @param[in] result The result of message sending
@@ -133,6 +143,7 @@ typedef void (*messages_sent_cb)(messages_sending_result_e result, void *user_da
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Called when an incoming message is received.
  * @since_tizen 2.3
  * @param[in] incoming_msg The incoming message
@@ -145,6 +156,7 @@ typedef void (*messages_incoming_cb)(messages_message_h incoming_msg, void *user
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Called when a message is retrieved from a search request.
  * @since_tizen 2.3
  * @remarks You should not call messages_destroy_message() with @a msg.
@@ -172,6 +184,7 @@ typedef bool (*messages_search_cb)(messages_message_h msg, int index, int result
 
 
 /**
+ * @deprecated Deprecated since 8.0.
  * @brief Called when an incoming push message is received.
  * @since_tizen 2.3
  * @param[in] header The header of the push message