#define __TIZEN_MESSAGING_H__
+#include <tizen.h>
#include <time.h>
#include <messages_types.h>
#include <messages_error.h>
/**
+ * @deprecated Deprecated since 8.0.
* @brief Opens a handle for the messaging service.
* @since_tizen 2.3
* @privlevel public
* @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
* @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().
* @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
* @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
* @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
* @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
* @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
* @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
* @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
* @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
* @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
* @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
* @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
* @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().
* @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
* @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
* @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().
* @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
* @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
* @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
* @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
* @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
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
* @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
* @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
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
* @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
* @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
* @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;
/**
/**
+ * @deprecated Deprecated since 8.0.
* @brief Sets the subject of the message.
* @since_tizen 2.3
* @param[in] msg The message handle
* @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().
* @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
* @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().
* @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
* @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
* @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;
/**
/**
+ * @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
* @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
* @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
* @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
* @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
* @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;
/**