SET(INC_DIR include)
INCLUDE_DIRECTORIES(${INC_DIR})
-SET(dependents "dlog glib-2.0 msg-service capi-base-common capi-appfw-application")
+SET(dependents "dlog glib-2.0 msg-service capi-base-common capi-appfw-application capi-system-info privacy-manager-client")
INCLUDE(FindPkgConfig)
pkg_check_modules(${fw_name} REQUIRED ${dependents})
SET(EXTRA_CFLAGS "${EXTRA_CFLAGS} ${flag}")
ENDFOREACH(flag)
-SET(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${EXTRA_CFLAGS} -fPIC -Wall -Werror")
+SET(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${EXTRA_CFLAGS} -fPIC -Wall")
SET(CMAKE_C_FLAGS_DEBUG "-O0 -g")
IF("${ARCH}" STREQUAL "arm")
ADD_DEFINITIONS("-DPREFIX=\"${CMAKE_INSTALL_PREFIX}\"")
ADD_DEFINITIONS("-DTIZEN_DEBUG")
-SET(CMAKE_EXE_LINKER_FLAGS "-Wl,--as-needed -Wl,--rpath=${LIB_INSTALL_DIR}")
+SET(CMAKE_EXE_LINKER_FLAGS "-Wl,--as-needed -Wl,--rpath=/usr/lib")
aux_source_directory(src SOURCES)
ADD_LIBRARY(${fw_name} SHARED ${SOURCES})
CLEAN_DIRECT_OUTPUT 1
)
-INSTALL(TARGETS ${fw_name} DESTINATION ${LIB_INSTALL_DIR})
+INSTALL(TARGETS ${fw_name} DESTINATION lib)
INSTALL(
DIRECTORY ${INC_DIR}/ DESTINATION include/messaging
FILES_MATCHING
${CMAKE_CURRENT_SOURCE_DIR}/${fw_name}.pc
@ONLY
)
-INSTALL(FILES ${CMAKE_CURRENT_SOURCE_DIR}/${fw_name}.pc DESTINATION ${LIB_INSTALL_DIR}/pkgconfig)
+INSTALL(FILES ${CMAKE_CURRENT_SOURCE_DIR}/${fw_name}.pc DESTINATION lib/pkgconfig)
ADD_SUBDIRECTORY(test)
--- /dev/null
+<manifest>
+ <request>
+ <domain name="_"/>
+ </request>
+</manifest>
prefix=@PREFIX@
exec_prefix=/usr
-libdir=@LIB_INSTALL_DIR@
+libdir=/usr/lib
includedir=/usr/include
Name: @PC_NAME@
--- /dev/null
+/*
+ * Copyright (c) 2011 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.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an AS IS BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+
+#ifndef __TIZEN_MESSAGES_DOC_H__
+#define __TIZEN_MESSAGES_DOC_H__
+
+/**
+ * @defgroup CAPI_MESSAGING_MESSAGES_MODULE Messages
+ * @brief The @ref CAPI_MESSAGING_MESSAGES_MODULE API provides functions to create, set properties and send a SMS/MMS message.
+ * @ingroup CAPI_MESSAGING_FRAMEWORK
+ *
+ * @addtogroup CAPI_MESSAGING_MESSAGES_MODULE
+ *
+ * @section CAPI_MESSAGING_MESSAGES_MODULE_HEADER Required Header
+ * \#include <messages.h>
+ *
+ * @section CAPI_MESSAGING_MESSAGES_MODULE_OVERVIEW Overview
+ *
+ * The Messages API provides the following functionalities:
+ *
+ * - Creating a message
+ * - Setting the text of the message
+ * - Setting the message recipient(s)
+ * - Sending a message
+ * - Searching for messages
+ * - Registering/Unregistering a callback function to check whether a message is sent successfully or not
+ * - Registering/Unregistering a callback function to receive notifications when an incoming message is received
+ *
+ * @section CAPI_MESSAGING_MESSAGES_MODULE_FEATURE Related Features
+ * This API is related with the following features:\n
+ * - http://tizen.org/feature/network.telephony\n
+ * - http://tizen.org/feature/network.telephony.mms\n
+ *
+ * It is recommended to design feature related codes in your application for reliability.\n
+ *
+ * You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, thereby controlling the procedure of your application.\n
+ *
+ * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n
+ *
+ * More details on featuring your application can be found from <a href="../org.tizen.mobile.native.appprogramming/html/ide_sdk_tools/feature_element.htm"><b>Feature Element</b>.</a>
+ * <BR>
+ */
+
+/**
+ * @defgroup CAPI_MESSAGING_MESSAGES_MMS_MODULE MMS
+ * @brief The MMS API provides functions to manage attachments and subject of the MMS message.
+ * @ingroup CAPI_MESSAGING_MESSAGES_MODULE
+ *
+ * @addtogroup CAPI_MESSAGING_MESSAGES_MMS_MODULE
+ *
+ * @section CAPI_MESSAGING_MESSAGES_MMS_MODULE_HEADER Required Header
+ * \#include <messages.h>
+ *
+ * @section CAPI_MESSAGING_MESSAGES_MMS_MODULE_OVERVIEW Overview
+ *
+ * The MMS API provides the following functionalities:
+ *
+ * - Setting/Getting the subject
+ * - Attaching the media files(image, video, audio)
+ * - Retrieving the attachments
+ * - Deleting all attachments
+ *
+ * @section CAPI_MESSAGING_MESSAGES_MMS_MODULE_FEATURE Related Features
+ * This API is related with the following features:\n
+ * - http://tizen.org/feature/network.telephony\n
+ * - http://tizen.org/feature/network.telephony.mms\n
+ *
+ * It is recommended to design feature related codes in your application for reliability.\n
+ *
+ * You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, thereby controlling the procedure of your application.\n
+ *
+ * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n
+ *
+ * More details on featuring your application can be found from <a href="../org.tizen.mobile.native.appprogramming/html/ide_sdk_tools/feature_element.htm"><b>Feature Element</b>.</a>
+ *
+ */
+
+/**
+ * @defgroup CAPI_MESSAGING_MESSAGES_PUSH_MODULE WAP Push
+ * @brief The WAP PUSH API provides functions to add/remove incoming callback for WAP Push messages and register current application to push server.
+ * @ingroup CAPI_MESSAGING_MESSAGES_MODULE
+ *
+ * @addtogroup CAPI_MESSAGING_MESSAGES_PUSH_MODULE
+ *
+ * @section CAPI_MESSAGING_MESSAGES_PUSH_MODULE_HEADER Required Header
+ * \#include <messages.h>
+ *
+ * @section CAPI_MESSAGING_MESSAGES_PUSH_MODULE_OVERVIEW Overview
+ *
+ * The WAP PUSH API provides the following functionalities:
+ *
+ * - Adding/Removing incoming callback for WAP Push messages
+ * - Managing the registration
+ *
+ * @section CAPI_MESSAGING_MESSAGES_PUSH_MODULE_FEATURE Related Features
+ * This API is related with the following features:\n
+ * - http://tizen.org/feature/network.telephony\n
+ *
+ * It is recommended to design feature related codes in your application for reliability.\n
+ *
+ * You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, thereby controlling the procedure of your application.\n
+ *
+ * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n
+ *
+ * More details on featuring your application can be found from <a href="../org.tizen.mobile.native.appprogramming/html/ide_sdk_tools/feature_element.htm"><b>Feature Element</b>.</a>
+ *
+ */
+
+
+#endif /* __TIZEN_MESSAGES_DOC_H__ */
* distributed under the License is distributed on an AS IS BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
- * limitations under the License.
+ * limitations under the License.
*/
#ifndef __TIZEN_MESSAGING_H__
/**
- * @brief Opens a handle for messaging service.
+ * @brief Opens a handle for the messaging service.
*
- * @remark @a service must be released with messages_close_service() by you.
+ * @since_tizen 2.3
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/message.read
+ *
+ * @remarks You must release @a service using messages_close_service().
*
* @param[out] service The message service handle
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_SERVER_NOT_READY Server is not read
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_SERVER_NOT_READY Server is not read
* @retval #MESSAGES_ERROR_COMMUNICATION_WITH_SERVER_FAILED Communication with server failed
+ * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @see messages_close_service()
*/
/**
- * @brief Closes a handle for messaging service.
+ * @brief Closes a handle for the messaging service.
+ *
+ * @since_tizen 2.3
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/message.read
*
* @param[in] service The message service handle
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #MESSAGES_ERROR_COMMUNICATION_WITH_SERVER_FAILED Communication with server failed
+ * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @see messages_open_service()
*/
/**
* @brief Creates a message handle.
*
- * @remark @a msg must be released with messages_destroy_message() by you.
+ * @since_tizen 2.3
+ *
+ * @remarks You must release @a msg using messages_destroy_message().
+ *
+ * @param[in] type The message type (#MESSAGES_TYPE_SMS or #MESSAGES_TYPE_MMS) \n
+ * If @a type is #MESSAGES_TYPE_UNKNOWN, #MESSAGES_ERROR_INVALID_PARAMETER occurs.
+ * @param[out] msg The message handle that is newly created if successful
*
- * @param[in] type A message type (MESSAGES_TYPE_SMS or MESSAGES_TYPE_MMS) \n
- * If @a type is #MESSAGES_TYPE_UNKNOWN, #MESSAGES_ERROR_INVALID_PARAMETER occurs.
- * @param[out] msg A message handle to be newly created if successful
+ * @return @c 0 on success,
+ * otherwise a negative error value
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @see messages_destroy_message()
*/
/**
- * @brief Destroys a message handle and release all its resources.
+ * @brief Destroys a message handle and releases all its resources.
*
- * @param[in] msg A message handle to destroy
+ * @since_tizen 2.3
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @param[in] msg The message handle to destroy
+ *
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @see messages_create_message()
*/
int messages_destroy_message(messages_message_h msg);
/**
- * @brief Gets the message id of the message.
+ * @brief Gets the message ID of the message.
*
- * @param[in] msg The message handle
- * @param[out] msg_id The message id
+ * @since_tizen 2.3
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
+ * @param[in] msg The message handle
+ * @param[out] msg_id The message ID
+ *
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
+ * @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);
+
+/**
+ * @brief Sets the SIM ID of the sending message.
+ *
+ * @since_tizen 2.3
+ *
+ * @param[in] msg The message handle
+ * @param[in] sim_id The SIM id to send message
+ *
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
+ *
+ * @see messages_get_sim_id()
+ */
+int messages_set_sim_id(messages_message_h msg, int sim_id);
+
+
+/**
+ * @brief Gets the SIM ID of the message.
+ *
+ * @since_tizen 2.3
+ *
+ * @param[in] msg The message handle
+ * @param[out] sim_id The SIM id of message
+ *
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
+ *
+ * @see messages_set_sim_id()
+ */
+int messages_get_sim_id(messages_message_h msg, int *sim_id);
+
+
/**
* @brief Gets the message box type of the message.
*
- * @param[in] msg The message handle
- * @param[out] mbox The message box type
+ * @since_tizen 2.3
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @param[in] msg The message handle
+ * @param[out] mbox The message box type
+ *
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @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);
/**
* @brief Gets the destination port of the message.
*
- * @param[in] msg The message handle
- * @param[out] port The destination port of the message
+ * @since_tizen 2.3
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @param[in] msg The message handle
+ * @param[out] port The destination port of the message
+ *
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @see messages_add_sms_listening_port()
*/
/**
* @brief Gets the type of the message.
*
- * @param[in] msg The message handle
+ * @since_tizen 2.3
+ *
+ * @param[in] msg The message handle
* @param[out] type The message type
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @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);
* @brief Adds an recipient's address(phone number) to the message.
* @details The maximum number of recipients per a message is 10.
*
- * @param[in] msg The message handle
- * @param[in] address The recipient's address to receive a message \n
- * The maximum length of @a address is 254.
- * @param[in] type The recipient's type of the @a address
+ * @since_tizen 2.3
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @param[in] msg The message handle
+ * @param[in] address The recipient's address to receive a message \n
+ * The maximum length of @a address is @c 254.
+ * @param[in] type The recipient's type of the @a address
+ *
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @see messages_get_address()
* @see messages_remove_all_addresses()
/**
* @brief Gets the total number of recipients in the message.
*
- * @param[in] msg The message handle
- * @param[out] count The total number of recipients
+ * @since_tizen 2.3
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @param[in] msg The message handle
+ * @param[out] count The total number of recipients
+ *
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @see messages_add_address()
* @see messages_remove_all_addresses()
/**
* @brief Gets a recipient's address with specified index.
*
- * @remarks @a address must be released with @c free() by you.
+ * @since_tizen 2.3
*
- * @param[in] msg The message handle
- * @param[in] index The zero-based index of address to receive a message.
- * @param[out] address The recipient's address with specified index
- * @param[out] type The recipient's type of the @a address.
+ * @remarks You must release @a address using free().
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @param[in] msg The message handle
+ * @param[in] index The zero-based index of an address to receive a message.
+ * @param[out] address The recipient's address with specified index
+ * @param[out] type The recipient's type of the @a address
+ *
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @see messages_add_address()
* @see messages_remove_all_addresses()
/**
* @brief Removes all recipients in the message.
*
+ * @since_tizen 2.3
+ *
* @param[in] msg The message handle
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @see messages_add_address()
* @see messages_get_address()
/**
* @brief Sets the text of the message.
*
- * @param[in] msg The message handle
+ * @since_tizen 2.3
+ *
+ * @param[in] msg The message handle
* @param[in] text The text of the message \n
- * The maximum length of @a text is 1530.
+ * The maximum length of @a text is @c 1530.
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @see messages_get_text()
*/
/**
* @brief Gets the text of the message.
*
- * @remarks @a text must be released with @c free() by you.
+ * @since_tizen 2.3
*
- * @param[in] msg The message handle
- * @param[out] text The text of the message
+ * @remarks You must release @a text using free().
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @param[in] msg The message handle
+ * @param[out] text The text of the message
+ *
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @see messages_set_text()
*/
/**
* @brief Gets the time of the message.
*
- * @param[in] msg The message handle
- * @param[out] time The time of the message
+ * @since_tizen 2.3
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @param[in] msg The message handle
+ * @param[out] time The time of the message
+ *
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @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);
/**
* @brief Sends the message to all recipients.
*
- * @remarks In order to check whether sending a message succeeds,
- * you should register messages_sent_cb() using messages_set_message_sent_cb().
+ * @since_tizen 2.3
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/message.write
*
- * @param[in] service The message service handle
- * @param[in] msg The message handle
- * @param[in] save_to_sentbox Set to true to save the message in the sentbox, else false
- * @param[in] callback The callback function
- * @param[in] user_data The user data to be passed to the callback function
+ * @param[in] service The message service handle
+ * @param[in] msg The message handle
+ * @param[in] save_to_sentbox Set to @c true to save the message in the sentbox,
+ * otherwise set to @c false to not save the message in the sentbox
+ * @param[in] callback The callback function
+ * @param[in] user_data The user data to be passed to the callback function
+ *
+ * @return @c 0 on success,
+ * otherwise a negative error value
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_SENDING_FAILED Sending a message failed
- * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
+ * @retval #MESSAGES_ERROR_SENDING_FAILED Sending a message failed
+ * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
+ * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
+ * @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);
/**
- * @brief Gets the message count in the specific message box
+ * @brief Gets the message count in the specific message box.
+ * @since_tizen 2.3
*
- * @param[in] service The message service handle
- * @param[in] mbox The message box type
- * @param[in] type The message type \n
- * If @a type is #MESSAGES_TYPE_UNKNOWN, all sms and mms messages are counted.
- * @param[out] count The number of messages
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/message.read
+ *
+ * @param[in] service The message service handle
+ * @param[in] mbox The message box type
+ * @param[in] type The message type \n
+ * If @a type is #MESSAGES_TYPE_UNKNOWN, all SMS and MMS messages are counted.
+ * @param[out] count The number of messages
+ *
+ * @return @c 0 on success,
+ * otherwise a negative error value
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
+ * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
+ * @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,
+int messages_get_message_count(messages_service_h service,
messages_message_box_e mbox, messages_message_type_e type,
int *count);
/**
* @brief Searches for messages.
*
- * @details @a message_array must be released with messages_free_message_array() by you.
- *
- * @param[in] service The message service handle
- * @param[in] mbox The message box type
- * @param[in] type The message type \n
- * If @a type is #MESSAGES_TYPE_UNKNOWN, all sms and mms messages are searched.
- * @param[in] keyword The keyword search in text and subject
- * @param[in] address The recipient address
- * @param[in] offset The start position (base 0)
- * @param[in] limit The maximum amount of messages to get (In case of 0, this method passes to the callback all searched messages.)
- * @param[out] message_array The array of the message handle
- * @param[out] length The number of messages of the message_array
- * @param[out] total The count of the messages that have been retrieved as a result without applying @a limit and @a offset. \n
- * The value can be used to calculate the total number of page views for the searched messages.\n
- * For example, if the count of message search is 50 and the limit is 20, then using this value, you can notice the total page is 3.
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
+ * @since_tizen 2.3
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/message.read
+ *
+ * @remarks You must release @a message_array using messages_free_message_array().
+ *
+ * @param[in] service The message service handle
+ * @param[in] mbox The message box type
+ * @param[in] type The message type \n
+ * If @a type is #MESSAGES_TYPE_UNKNOWN, all SMS and MMS messages are searched.
+ * @param[in] keyword The keyword search in the text and subject
+ * @param[in] address The recipient address
+ * @param[in] offset The start position (base @c 0)
+ * @param[in] limit The maximum amount of messages to get \n
+ * In case of @c 0, this method passes to the callback all searched messages.
+ * @param[out] message_array The array of the message handle
+ * @param[out] length The number of messages of the @a message_array
+ * @param[out] total The count of the messages that have been retrieved as a result without applying @a limit and @a offset\ n
+ * The value can be used to calculate the total number of page views for the searched messages\ n
+ * For example, if the count of message search is @c 50 and the limit is @c 20, then using this value, you can notice the total page is @c 3.
+ *
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
+ * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @see messages_free_message_array()
*/
const char *keyword, const char *address,
int offset, int limit,
messages_message_h **message_array, int *length, int *total);
-
+
/**
- * @brief Searches a message with the given message id.
+ * @brief Searches a message with the given message ID.
*
- * @remark @a msg must be released with messages_destroy_message() by you.
+ * @since_tizen 2.3
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/message.read
*
- * @param[in] service The message service handle
- * @param[in] msg_id The message id
- * @param[out] msg A message handle to be newly created if successful
+ * @remarks You must release @a msg using messages_destroy_message().
+ *
+ * @param[in] service The message service handle
+ * @param[in] msg_id The message ID
+ * @param[out] msg The message handle that is newly created if successful
+ *
+ * @return @c 0 on success,
+ * otherwise a negative error value
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @see messages_get_message_id()
*/
/**
- * @brief Frees message array.
+ * @brief Frees the message array.
+ *
+ * @since_tizen 2.3
*
* @param[in] message_array The array of the message handle
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @see messages_search_message()
*/
/**
* @brief Retrieves the searched messages by invoking the given callback function iteratively.
*
- * @param[in] service The message service handle
- * @param[in] mbox The message box type
- * @param[in] type The message type \n
- * If @a type is #MESSAGES_TYPE_UNKNOWN, all sms and mms messages are searched.
- * @param[in] keyword The keyword search in text and subject
- * @param[in] address The recipient address
- * @param[in] offset The start position (base 0)
- * @param[in] limit The maximum amount of messages to get (In case of 0, this method passes to the callback all searched messages.)
- * @param[in] callback The callback function to get a message
+ * @since_tizen 2.3
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/message.read
+ *
+ * @param[in] service The message service handle
+ * @param[in] mbox The message box type
+ * @param[in] type The message type \n
+ * If @a type is #MESSAGES_TYPE_UNKNOWN, all SMS and MMS messages are searched.
+ * @param[in] keyword The keyword search in the text and subject
+ * @param[in] address The recipient address
+ * @param[in] offset The start position (base 0)
+ * @param[in] limit The maximum amount of messages to get \n
+ * In case of @c 0, this method passes to the callback all searched messages.
+ * @param[in] callback The callback function to get a message
* @param[in] user_data The user data to be passed to the callback function
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
+ * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @post It invokes messages_search_cb().
+ *
* @see messages_search_cb()
*/
int messages_foreach_message(messages_service_h service,
/**
* @brief Registers a callback to be invoked when an incoming message is received.
*
- * @param[in] service The message service handle
- * @param[in] callback The callback function
+ * @since_tizen 2.3
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/message.read
+ *
+ * @param[in] service The message service handle
+ * @param[in] callback The callback function
* @param[in] user_data The user data to be passed to the callback function
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
+ * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
+ * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @post It will invoke messages_incoming_cb().
*
/**
* @brief Unregisters the callback function.
*
+ * @since_tizen 2.3
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/message.write
+ *
* @param[in] service The message service handle
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @see messages_set_message_incoming_cb()
* @see messages_incoming_cb()
/**
* @brief Adds an additional listening port for the incoming SMS messages.
*
+ * @since_tizen 2.3
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/message.read
+ *
* @param[in] service The message service handle
- * @param[in] port The listening port for the SMS messages
+ * @param[in] port The listening port for the SMS messages
+ *
+ * @return @c 0 on success,
+ * otherwise a negative error value
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @see messages_set_message_incoming_cb()
* @see messages_get_message_port()
*/
int messages_add_sms_listening_port(messages_service_h service, int port);
+
/**
* @addtogroup CAPI_MESSAGING_MESSAGES_MMS_MODULE
* @{
/**
* @brief Sets the subject of the message.
*
- * @param[in] msg The message handle
+ * @since_tizen 2.3
+ *
+ * @param[in] msg The message handle
* @param[in] subject The subject of the message \n
- * The maximum length of @a subject is 120.
+ * The maximum length of @a subject is @c 120.
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @pre @a msg is created as a #MESSAGES_TYPE_MMS.
*
/**
* @brief Gets the subject of the message.
*
- * @remarks @a subject must be released with @c free() by you.
+ * @since_tizen 2.3
*
- * @param[in] msg The message handle
+ * @remarks You must release @a subject using free().
+ *
+ * @param[in] msg The message handle
* @param[out] subject The subject of the message
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @pre @a msg is created as a #MESSAGES_TYPE_MMS.
*
/**
* @brief Adds the attachment to the MMS message.
*
- * @param[in] msg The message handle
+ * @since_tizen 2.3
+ *
+ * @param[in] msg The message handle
* @param[in] type The attachment type
* @param[in] path The file path to attach \n
- * The maximum length of @a path is 1024.
+ * The maximum length of @a path is @c 1024.
+ *
+ * @return @c 0 on success,
+ * otherwise a negative error value
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @pre @a msg is created as a #MESSAGES_TYPE_MMS.
*
* @see messages_mms_get_attachment()
* @see messages_mms_get_attachment_count()
- * @see messages_mms_remove_all_attachments()
+ * @see messages_mms_remove_all_attachments()
*/
int messages_mms_add_attachment(messages_message_h msg, messages_media_type_e type, const char *path);
/**
* @brief Gets the file path of the attachment with the specified index.
*
- * @remark @a path must be released with @c free() by you.
+ * @since_tizen 2.3
*
- * @param[in] msg The message handle
- * @param[in] index The zero-based index of attachment
- * @param[out] type The attachment type
- * @param[out] path The file path to attach
+ * @remarks You must release @a path using free().
+ *
+ * @param[in] msg The message handle
+ * @param[in] index The zero-based index of the attachment
+ * @param[out] type The attachment type
+ * @param[out] path The file path to attach
+ *
+ * @return @c 0 on success,
+ * otherwise a negative error value
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @pre @a msg is created as a #MESSAGES_TYPE_MMS.
*
* @see messages_mms_add_attachment()
* @see messages_mms_get_attachment_count()
- * @see messages_mms_remove_all_attachments()
+ * @see messages_mms_remove_all_attachments()
*/
int messages_mms_get_attachment(messages_message_h msg, int index, messages_media_type_e *type, char **path);
/**
* @brief Gets the attachment with the specified index.
*
- * @param[in] msg The message handle
+ * @since_tizen 2.3
+ *
+ * @param[in] msg The message handle
* @param[out] count The total number of attachments
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @pre @a msg is created as a #MESSAGES_TYPE_MMS.
*
* @see messages_mms_add_attachment()
* @see messages_mms_get_attachment()
- * @see messages_mms_remove_all_attachments()
+ * @see messages_mms_remove_all_attachments()
*/
int messages_mms_get_attachment_count(messages_message_h msg, int *count);
/**
* @brief Removes all attachments to the MMS message.
*
+ * @since_tizen 2.3
+ *
* @param[in] msg The message handle
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
* @pre @a msg is created as a #MESSAGES_TYPE_MMS.
*
* @see messages_mms_add_attachment()
* @see messages_mms_get_attachment()
- * @see messages_mms_get_attachment_count()
+ * @see messages_mms_get_attachment_count()
*/
int messages_mms_remove_all_attachments(messages_message_h msg);
/**
/**
* @brief Registers a callback to be invoked when an WAP Push message is received.
*
- * @param[in] service The message service handle
- * @param[in] app_id The "X-WAP-Application-ID" to indicate a destination WAP Push application id.
- * @param[in] callback The callback function
+ * @since_tizen 2.3
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/message.read
+ *
+ * @param[in] service The message service handle
+ * @param[in] app_id The "X-WAP-Application-ID" to indicate a destination WAP Push application ID
+ * @param[in] callback The callback function
* @param[in] user_data The user data to be passed to the callback function
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @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_add_incoming_cb(messages_service_h service, const char *app_id,
+int messages_push_add_incoming_cb(messages_service_h service, const char *app_id,
messages_push_incoming_cb callback, void *user_data);
/**
* @brief Unregisters the WAP push incoming callback function.
*
+ * @since_tizen 2.3
+ *
* @param[in] service The message service handle
- * @param[in] app_id The "X-WAP-Application-ID" to indicate a destination WAP Push application id
+ * @param[in] app_id The "X-WAP-Application-ID" to indicate a destination WAP Push application ID
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @return @c 0 on success,
+ * otherwise a negative error value
+ *
+ * @retval #MESSAGES_ERROR_NONE Successful
* @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);
/**
* @brief Registers an application to the mapping table of the WAP Push service.
*
- * @param[in] service The message service handle
- * @param[in] content_type The MIME content type of the content
- * @param[in] app_id The "X-WAP-Application-ID" to indicate a destination WAP Push application id
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_push_register(messages_service_h service, const char *content_type, const char *app_id);
-
-
-/**
- * @brief Deregisters an application from the mapping table of the WAP Push service.
+ * @since_tizen 2.3
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/message.write
*
- * @param[in] service The message service handle
+ * @param[in] service The message service handle
* @param[in] content_type The MIME content type of the content
- * @param[in] app_id The "X-WAP-Application-ID" to indicate a destination WAP Push application id
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_push_deregister(messages_service_h service, const char *content_type, const char *app_id);
-
-
-/**
- * @brief Re-registers an application to the mapping table of the WAP Push service.
- *
- * @param[in] service The message service handle
- * @param[in] content_type An element of the composite key for searching registered entry.\n
- * The MIME content type of the content.
- * @param[in] app_id The The composite key for searching mapping information.\n
- * "X-WAP-Application-ID" to indicate a destination WAP Push application id.
- * @param[in] dst_content_type The MIME content type of the content.
- * @param[in] dst_app_id The "X-WAP-Application-ID" to indicate a destination WAP Push application id.
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-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);
-
-/**
- * @}
- */
-
-
-/**
- * @addtogroup CAPI_MESSAGING_MESSAGES_CB_MODULE
- * @{
- */
-
-/**
- * @brief Gets the message id of the CB message.
+ * @param[in] app_id The "X-WAP-Application-ID" to indicate a destination WAP Push application ID
*
- * @param[in] msg The CB message handle
- * @param[out] msg_id The message id of the CB message
+ * @return @c 0 on success,
+ * otherwise a negative error value
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @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_cb_get_message_id(messages_cb_message_h msg, int *msg_id);
-
-/**
- * @brief Gets the serial number of the CB message.
- *
- * @param[in] msg The CB message handle
- * @param[out] serial The serial number of the CB message (16-bit integer)
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_cb_get_serial_number(messages_cb_message_h msg, int *serial);
-
-/**
- * @brief Gets the DCS(Data Coding Scheme) value of the CB message.
- *
- * @param[in] msg The CB message handle
- * @param[out] dcs The DCS value of the CB message (8-bit integer)
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_cb_get_dcs(messages_cb_message_h msg, int *dcs);
-
-/**
- * @brief Gets the message type of the CB message.
- *
- * @param[in] msg The CB message handle
- * @param[out] type The message type of the CB message
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_cb_get_message_type(messages_cb_message_h msg, messages_message_type_e *type);
-
-
-/**
- * @brief Gets the language type of the CB message.
- *
- * @remarks @a type must be released with @c free() by you.
- *
- * @param[in] msg The CB message handle
- * @param[out] text The language type of the CB message
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
- */
-int messages_cb_get_language_type(messages_cb_message_h msg, char **type);
-
-/**
- * @brief Gets the text contents of the CB message.
- *
- * @remarks @a text must be released with @c free() by you.
- *
- * @param[in] msg The CB message handle
- * @param[out] text The the text of the CB message
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OPERATION_FAILED if the type of @a msg is MESSAGES_CB_TYPE_ETWS_PRIMARY
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
- */
-int messages_cb_get_text(messages_cb_message_h msg, char **text);
-
-
-/**
- * @brief Gets the received time of the CB message.
- *
- * @param[in] msg The CB message handle
- * @param[out] time The recieved time of the CB message
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_cb_get_time(messages_cb_message_h msg, time_t *time);
-
-
-/**
- * @brief Registers a callback to be invoked when an CB message is received.
- *
- * @param[in] service The message service handle
- * @param[in] save Set to true to save the message, else false.
- * @param[in] callback The callback function
- * @param[in] user_data The user data to be passed to the callback function
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_cb_set_incoming_cb(messages_service_h service, bool save,
- messages_cb_incoming_cb callback, void *user_data);
-
-
-/**
- * @brief Unregisters the callback function for cb incoming message.
- *
- * @param[in] service The message service handle
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_cb_unset_incoming_cb(messages_service_h service);
-
-/**
- * @brief Registers a callback to be invoked when an ETWS primary notification message is received.
- *
- * @param[in] service The message service handle
- * @param[in] callback The callback function
- * @param[in] user_data The user data to be passed to the callback function
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_cb_set_etws_primary_noti_cb(messages_service_h service,
- messages_cb_etws_primary_noti_cb callback, void *user_data);
-
-/**
- * @brief Unregisters the callback function for ETWS primary notification message is received.
- *
- * @param[in] service The message service handle
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_cb_unset_etws_primary_noti_cb(messages_service_h service);
-
-
-/**
- * @brief Loads the settings for CB messaging.
- *
- * @remark The @a settings will be free automatically when the @a service is destroyed.
- *
- * @param[in] service The message service handle
- * @param[out] settings The settings handle
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
- */
-int messages_cb_load_settings(messages_service_h service, messages_cb_settings_h *settings);
-
-/**
- * @brief Saves the settings for CB messaging.
- *
- * @param[in] service The message service handle
- * @param[in] settings The settings handle
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_cb_save_settings(messages_service_h service, messages_cb_settings_h settings);
-
-/**
- * @brief Enables or disables the CB messaging.
- *
- * @param[in] settings The settings handle
- * @param[in] enabled If true, the CB messaging is enabled. otherwise the CB messaging is disabled.
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_cb_settings_set_enabled(messages_cb_settings_h settings, bool enabled);
-
-/**
- * @brief Determines whether the CB messaging is enabled.
- *
- * @param[in] settings The settings handle
- * @param[out] enabled true if the CB messaging is enabled, false otherwise.
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_cb_settings_is_enabled(messages_cb_settings_h settings, bool *enabled);
-
-/**
- * @brief Adds a channel to the CB messaging settings.
- *
- * @param[in] settings The settings handle
- * @param[in] channel The channel handle to add
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_RANGE Maximum cb channels exceeded
- */
-int messages_cb_settings_add_channel(messages_cb_settings_h settings, messages_cb_channel_h channel);
-
-/**
- * @brief Removes a channel from the CB messaging settings.
- *
- * @param[in] settings The settings handle
- * @param[in] channel The channel handle to remove
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_cb_settings_remove_channel(messages_cb_settings_h settings, messages_cb_channel_h channel);
+int messages_push_register(messages_service_h service, const char *content_type, const char *app_id);
-/**
- * @brief Gets a channel from the CB messaging settings.
- *
- * @param[in] settings The settings handle
- * @param[in] index The zero-based index of channel to receive
- * @param[out] channel The channel with specified index
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OPERATION_FAILED Messaging operation failed
- */
-int messages_cb_settings_get_channel(messages_cb_settings_h settings, int index, messages_cb_channel_h *channel);
/**
- * @brief Gets the total number of channels in the settings.
+ * @brief De-registers an application from the mapping table of the WAP Push service.
*
- * @param[in] settings The settings handle
- * @param[out] count The total number of channels
+ * @since_tizen 2.3
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/message.write
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_cb_settings_get_channel_count(messages_cb_settings_h settings, int *count);
-
-/**
- * @brief Creates a channel handle.
- *
- * @remark @a channel must be released with messages_cb_destroy_channel() by you.
+ * @param[in] service The message service handle
+ * @param[in] content_type The MIME content type of the content
+ * @param[in] app_id The "X-WAP-Application-ID" to indicate a destination WAP Push application ID
*
- * @param[out] channel A message handle to be newly created if successful
+ * @return @c 0 on success,
+ * otherwise a negative error value
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_MEMORY Out of memory
+ * @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_cb_create_channel(messages_cb_channel_h *channel);
+int messages_push_deregister(messages_service_h service, const char *content_type, const char *app_id);
-/**
- * @brief Destroys a channel handle and release all its resource.
- *
- * @param[in] channel A channel handle to destroy
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_cb_destroy_channel(messages_cb_channel_h channel);
/**
- * @brief Sets the range of channel id values for the CB messaging.
+ * @brief Re-registers an application to the mapping table of the WAP Push service.
*
- * @param[in] channel The channel handle
- * @param[in] from_id The start of the range of channel id values.
- * @param[in] to_id The end of the range of channel id values.
+ * @since_tizen 2.3
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/message.write
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_cb_channel_set_id(messages_cb_channel_h channel, int from_id, int to_id);
-
-/**
- * @brief Gets the range of channel id values for the CB messaging.
+ * @param[in] service The message service handle
+ * @param[in] content_type An element of the composite key for searching registered entry \n
+ * The MIME content type of the content.
+ * @param[in] app_id The composite key for searching mapping information \n
+ * The "X-WAP-Application-ID" to indicate a destination WAP Push application ID.
+ * @param[in] dst_content_type The MIME content type of the content
+ * @param[in] dst_app_id The "X-WAP-Application-ID" to indicate a destination WAP Push application ID
*
- * @param[in] channel The channel handle
- * @param[out] from_id The start of the range of channel id values.
- * @param[out] to_id The end of the range of channel id values.
+ * @return @c 0 on success,
+ * otherwise a negative error value
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
+ * @retval #MESSAGES_ERROR_NONE Successful
* @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_cb_channel_get_id(messages_cb_channel_h channel, int *from_id, int *to_id);
-
-/**
- * @brief Sets the name of the channel.
- *
- * @param[in] channel The channel handle
- * @param[in] name The name of the channel
+ * @retval #MESSAGES_ERROR_PERMISSION_DENIED The application does not have the privilege to call this method
+ * @retval #MESSAGES_ERROR_NOT_SUPPORTED Not supported
*
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MESSAGES_ERROR_OUT_OF_RANGE Maximum length of name exceeded
- */
-int messages_cb_channel_set_name(messages_cb_channel_h channel, const char *name);
-
-/**
- * @brief Gets the name of the channel.
- *
- * @param[in] channel The channel handle
- * @param[out] name The name of the channel
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
*/
-int messages_cb_channel_get_name(messages_cb_channel_h channel, char **name);
+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);
/**
- * @brief Activates or deactivates a specific channel.
- *
- * @param[in] channel The channel handle
- * @param[in] activated If true, the channel is activated. otherwise, the channel is deactivated.
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
+ * @}
*/
-int messages_cb_channel_set_activated(messages_cb_channel_h channel, bool activated);
/**
- * @brief Determines whether the channel is activated.
- *
- * @param[in] channel The channel handle
- * @param[out] activated true If the channel is activated, false otherwise.
- *
- * @return 0 on success, otherwise a negative error value.
- * @retval #MESSAGES_ERROR_NONE Successful
- * @retval #MESSAGES_ERROR_INVALID_PARAMETER Invalid parameter
- */
-int messages_cb_channel_is_activated(messages_cb_channel_h channel, bool *activated);
-
-
-
-/**
* @}
*/
-
#ifdef __cplusplus
}
#endif
MESSAGES_ERROR_NONE = TIZEN_ERROR_NONE, /**< Successful */
MESSAGES_ERROR_OUT_OF_MEMORY = TIZEN_ERROR_OUT_OF_MEMORY, /**< Out of memory */
MESSAGES_ERROR_INVALID_PARAMETER = TIZEN_ERROR_INVALID_PARAMETER, /**< Invalid parameter */
- MESSAGES_ERROR_SERVER_NOT_READY = TIZEN_ERROR_MESSAGING_CLASS|0x501, /**< Server is not read */
- MESSAGES_ERROR_COMMUNICATION_WITH_SERVER_FAILED = TIZEN_ERROR_MESSAGING_CLASS|0x502, /**< Communication with server failed */
- MESSAGES_ERROR_OUT_OF_RANGE = TIZEN_ERROR_MESSAGING_CLASS|0x503, /**< Index out of range */
- MESSAGES_ERROR_SENDING_FAILED = TIZEN_ERROR_MESSAGING_CLASS|0x504, /**< Sending a message failed */
- MESSAGES_ERROR_OPERATION_FAILED = TIZEN_ERROR_MESSAGING_CLASS|0x505, /**< Messaging operation failed */
- MESSAGES_ERROR_NO_SIM_CARD = TIZEN_ERROR_MESSAGING_CLASS|0x506, /**< No SIM Card */
- MESSAGES_ERROR_NO_DATA = TIZEN_ERROR_MESSAGING_CLASS|0x507, /**< No data available */
+ MESSAGES_ERROR_SERVER_NOT_READY = TIZEN_ERROR_MESSAGING_SERVICE|0x501, /**< Server is not read */
+ MESSAGES_ERROR_COMMUNICATION_WITH_SERVER_FAILED = TIZEN_ERROR_MESSAGING_SERVICE|0x502, /**< Communication with server failed */
+ MESSAGES_ERROR_OUT_OF_RANGE = TIZEN_ERROR_MESSAGING_SERVICE|0x503, /**< Index out of range */
+ MESSAGES_ERROR_SENDING_FAILED = TIZEN_ERROR_MESSAGING_SERVICE|0x504, /**< Sending a message failed */
+ MESSAGES_ERROR_OPERATION_FAILED = TIZEN_ERROR_MESSAGING_SERVICE|0x505, /**< Messaging operation failed */
+ MESSAGES_ERROR_NO_SIM_CARD = TIZEN_ERROR_MESSAGING_SERVICE|0x506, /**< No SIM Card */
+ MESSAGES_ERROR_NO_DATA = TIZEN_ERROR_MESSAGING_SERVICE|0x507, /**< No data available */
+ MESSAGES_ERROR_PERMISSION_DENIED = TIZEN_ERROR_PERMISSION_DENIED, /**< Permission denied */
+ MESSAGES_ERROR_NOT_SUPPORTED = TIZEN_ERROR_NOT_SUPPORTED, /**< Not supported */
} messages_error_e;
/**
* distributed under the License is distributed on an AS IS BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
- * limitations under the License.
+ * limitations under the License.
*/
#ifndef __TIZEN_MESSAGING_PRIVATE_H__
{
#endif
+#include <system_info.h>
+
typedef struct _messages_service_s {
msg_handle_t service_h;
void* incoming_cb;
bool incoming_cb_enabled;
GSList* sent_cb_list;
GSList* push_incoming_cb_list;
-
- bool cbs_enabled_cb;
-
- void* cbs_incoming_cb;
- void* cbs_incoming_cb_user_data;
- bool cbs_incoming_cb_save;
-
- void* etws_incoming_cb;
- void* etws_incoming_cb_user_data;
-
- messages_cb_settings_h cbs_settings_h;
} messages_service_s;
typedef struct _messages_message_s {
void* user_data;
} messages_push_incoming_callback_s;
+#define MESSAGES_PRIVILEGE_READ "http://tizen.org/privilege/message.read"
+#define MESSAGES_PRIVILEGE_WRITE "http://tizen.org/privilege/message.write"
-
-// CBS
-
-#define MESSAGES_ETWS_WARNING_INFO_LEN 50
-
-typedef struct _messages_cb_message_s {
- msg_struct_t cb_msg_h;
-} messages_cb_message_s;
-
-typedef struct _messages_cb_settings_s {
- msg_struct_t _struct;
- GSList* channel_list;
-} messages_cb_settings_s;
-
-typedef struct _messages_cb_channel_s {
- int from_id;
- int to_id;
- char name[CB_CHANNEL_NAME_MAX + 1];
- bool activated;
-} messages_cb_channel_s;
-
-
+#define MESSAGES_TELEPHONY_FEATURE "http://tizen.org/feature/network.telephony"
+#define MESSAGES_TELEPHONY_MMS_FEATURE "http://tizen.org/feature/network.telephony.mms"
#define ERROR_CONVERT(err) _messages_error_converter(err, __FUNCTION__, __LINE__);
#define CHECK_NULL(p) \
__FUNCTION__, MESSAGES_ERROR_INVALID_PARAMETER, #p); \
return MESSAGES_ERROR_INVALID_PARAMETER; \
}
-
+
#define IS_SMS(x) ((x & MESSAGES_TYPE_SMS) == MESSAGES_TYPE_SMS)
#define IS_MMS(x) ((x & MESSAGES_TYPE_MMS) == MESSAGES_TYPE_MMS)
-
+#define CHECK_MESSAGES_SUPPORTED(feature_name) \
+ do { \
+ bool is_supported = false; \
+ if (!system_info_get_platform_bool(feature_name, &is_supported)) { \
+ if (is_supported == false) { \
+ LOGE("[%s] feature is disabled", feature_name); \
+ return MESSAGES_ERROR_NOT_SUPPORTED; \
+ } \
+ } else { \
+ LOGE("Error - Feature getting from System Info"); \
+ return MESSAGES_ERROR_OPERATION_FAILED; \
+ } \
+ } while(0)
+
int _messages_convert_mbox_to_fw(messages_message_box_e mbox);
int _messages_convert_msgtype_to_fw(messages_message_type_e type);
int _messages_convert_recipient_to_fw(messages_recipient_type_e type);
int _messages_error_converter(int err, const char *func, int line);
-int _messages_cb_clear_settings(messages_cb_settings_s *settings);
-
#ifdef __cplusplus
}
#endif
* distributed under the License is distributed on an AS IS BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
- * limitations under the License.
+ * limitations under the License.
*/
#ifndef __TIZEN_MESSAGING_TYPES_H__
#include <stdbool.h>
+#include <dlog.h>
+
+#ifdef LOG_TAG
+#undef LOG_TAG
+#endif
+#define LOG_TAG "CAPI_MESSAGING"
+#define DBG_MODE (1)
+
#ifdef __cplusplus
extern "C"
{
/**
* @brief The messaging service handle.
+ * @since_tizen 2.3
*/
typedef struct messages_service_s *messages_service_h;
/**
* @brief The message handle.
+ * @since_tizen 2.3
*/
typedef struct messages_message_s *messages_message_h;
/**
- * @brief The message box type.
+ * @brief Enumeration for the message box type.
+ * @since_tizen 2.3
*/
typedef enum {
- MESSAGES_MBOX_ALL = 0, /**< All message box type */
- MESSAGES_MBOX_INBOX = 1, /**< Inbox type */
- MESSAGES_MBOX_OUTBOX = 2, /**< Outbox type*/
- MESSAGES_MBOX_SENTBOX = 3, /**< Sentbox type */
- MESSAGES_MBOX_DRAFT = 4, /**< Draft type */
+ MESSAGES_MBOX_ALL = 0, /**< All message box type */
+ MESSAGES_MBOX_INBOX = 1, /**< Inbox type */
+ MESSAGES_MBOX_OUTBOX = 2, /**< Outbox type*/
+ MESSAGES_MBOX_SENTBOX = 3, /**< Sentbox type */
+ MESSAGES_MBOX_DRAFT = 4, /**< Draft type */
} messages_message_box_e;
/**
- * @brief The message type.
+ * @brief Enumeration for the message type.
+ * @since_tizen 2.3
*/
typedef enum {
- MESSAGES_TYPE_UNKNOWN = 0, /**< Unknown type */
- MESSAGES_TYPE_SMS = 1, /**< SMS type */
- MESSAGES_TYPE_MMS = 2, /**< MMS type */
- MESSAGES_TYPE_SMS_CB = MESSAGES_TYPE_SMS | 1 << 4, /**< CB(Cell Broadcast) Type */
- MESSAGES_TYPE_SMS_PUSH = MESSAGES_TYPE_SMS | 10 << 4, /**< WAP Push Type */
- MESSAGES_TYPE_SMS_ETWS_PRIMARY = MESSAGES_TYPE_SMS | 21 << 4, /**< ETWS(Earthquake and Tsunami Warning System) Primary Type */
- MESSAGES_TYPE_SMS_ETWS_SECONDARY = MESSAGES_TYPE_SMS | 22 << 4, /**< ETWS(Earthquake and Tsunami Warning System) Secondary Type */
+ MESSAGES_TYPE_UNKNOWN = 0, /**< Unknown type */
+ MESSAGES_TYPE_SMS = 1, /**< SMS type */
+ MESSAGES_TYPE_MMS = 2, /**< MMS type */
+ MESSAGES_TYPE_SMS_CB = MESSAGES_TYPE_SMS | 1 << 4, /**< CB(Cell Broadcast) Type */
+ MESSAGES_TYPE_SMS_PUSH = MESSAGES_TYPE_SMS | 10 << 4, /**< WAP Push Type */
+ MESSAGES_TYPE_SMS_ETWS_PRIMARY = MESSAGES_TYPE_SMS | 21 << 4, /**< ETWS(Earthquake and Tsunami Warning System) Primary Type */
+ MESSAGES_TYPE_SMS_ETWS_SECONDARY = MESSAGES_TYPE_SMS | 22 << 4, /**< ETWS(Earthquake and Tsunami Warning System) Secondary Type */
} messages_message_type_e;
/**
- * @brief The attachment type for MMS messaging.
+ * @brief Enumeration for the attachment type for MMS messaging.
+ * @since_tizen 2.3
*/
typedef enum {
- MESSAGES_MEDIA_UNKNOWN = 0, /**< Unknown */
- MESSAGES_MEDIA_IMAGE = 1, /**< The image */
- MESSAGES_MEDIA_AUDIO = 2, /**< The audio */
- MESSAGES_MEDIA_VIDEO = 3, /**< The video */
+ MESSAGES_MEDIA_UNKNOWN = 0, /**< Unknown */
+ MESSAGES_MEDIA_IMAGE = 1, /**< The image */
+ MESSAGES_MEDIA_AUDIO = 2, /**< The audio */
+ MESSAGES_MEDIA_VIDEO = 3, /**< The video */
} messages_media_type_e;
/**
- * @brief The recipient type of a message.
+ * @brief Enumeration for the recipient type of a message.
+ * @since_tizen 2.3
*/
typedef enum {
MESSAGES_RECIPIENT_UNKNOWN = 0, /**< Unknown */
- MESSAGES_RECIPIENT_TO = 1, /**< The 'To' recipient */
- MESSAGES_RECIPIENT_CC = 2, /**< The 'Cc' (carbon copy) recipient */
- MESSAGES_RECIPIENT_BCC = 3, /**< The 'Bcc' (blind carbon copy) recipient */
+ MESSAGES_RECIPIENT_TO = 1, /**< The 'To' recipient */
+ MESSAGES_RECIPIENT_CC = 2, /**< The 'Cc' (carbon copy) recipient */
+ MESSAGES_RECIPIENT_BCC = 3, /**< The 'Bcc' (blind carbon copy) recipient */
} messages_recipient_type_e;
/**
- * @brief The result of sending a message.
+ * @brief Enumeration for the result of sending a message.
+ * @since_tizen 2.3
*/
typedef enum {
- MESSAGES_SENDING_FAILED = -1, /**< Message sending is failed */
- MESSAGES_SENDING_SUCCEEDED = 0, /**< Message sending is succeeded */
+ MESSAGES_SENDING_FAILED = -1, /**< Message sending failed */
+ MESSAGES_SENDING_SUCCEEDED = 0, /**< Message sending succeeded */
} messages_sending_result_e;
/**
- * @brief Called when the process of sending a message to all recipients finishes.
+ * @brief Enumeration for the SIM index of a message.
+ * @since_tizen 2.3
+ */
+typedef enum {
+ MESSAGES_SIM_INDEX_UNKNOWN = 0, /**< Unknown SIM Index*/
+ MESSAGES_SIM_INDEX_1 = 1, /**< SIM Index 1 */
+ MESSAGES_SIM_INDEX_2 = 2, /**< SIM Index 2 */
+} messages_sim_index_e;
+
+
+/**
+ * @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.
- * @param[in] user_data The user data passed from the callback registration function
+ * @param[in] result The result of message sending
+ * @param[in] user_data The user data passed from the callback registration function
*
- * @pre messages_send_message() will invoke this callback if you register this callback using messages_set_message_sent_cb().
+ * @pre messages_send_message() will invoke this callback function.
*
- * @see messages_set_message_sent_cb()
- * @see messages_unset_message_sent_cb()
* @see messages_send_message()
*/
typedef void (* messages_sent_cb)(messages_sending_result_e result, void *user_data);
/**
* @brief Called when an incoming message is received.
+ * @since_tizen 2.3
*
- * @param[in] incoming_msg An incoming message
- * @param[in] user_data The user data passed from the callback registration function
+ * @param[in] incoming_msg The incoming message
+ * @param[in] user_data The user data passed from the callback registration function
*
* @pre You register this callback using messages_set_message_incoming_cb() for getting an incoming message.
*
/**
* @brief Called when a message is retrieved from a search request.
+ * @since_tizen 2.3
*
- * @remark You should not call messages_destroy_message() with @a msg.
+ * @remarks You should not call messages_destroy_message() with @a msg.
*
- * @param[in] msg The message handle (It can be NULL if nothing is found)
- * @param[in] user_data The user data passed from the foreach function
- * @param[in] index The index of a message from the messages that have been retrieved as a search result
- * @param[in] result_count The count of the messages that have been retrieved as a result applying @a limit and @a offset.\n
- * If the search has a @a limit, then this value is always equal or less than the limit.
- * @param[in] total_count The count of the messages that have been retrieved as a result without applying @a limit and @a offset. \n
- * The value can be used to calculate the total number of page views for the searched meessages.\n
- * For example, if the count of message search is 50 and the limit is 20, then using this value, you can notice the total page is 3.
+ * @param[in] msg The message handle \n
+ * It can be @c NULL if nothing is found.
+ * @param[in] user_data The user data passed from the foreach function
+ * @param[in] index The index of a message from the messages that have been retrieved as a search result
+ * @param[in] result_count The count of the messages that have been retrieved as a result applying @a limit and @a offset \n
+ * If the search has a @a limit, then this value is always equal or less than the limit.
+ * @param[in] total_count The count of the messages that have been retrieved as a result without applying @a limit and @a offset \n
+ * The value can be used to calculate the total number of page views for the searched messages. \n
+ * For example, if the count of message search is @c 50 and the limit is @c 20, then using this value, you can notice the total page is @c 3.
*
- * @return @c true to continue with the next iteration of the loop or return @c false to break out of the loop.
+ * @return @c true to continue with the next iteration of the loop,
+ * otherwise return @c false to break out of the loop
*
* @pre messages_foreach_message() will invoke this callback function.
*
* @addtogroup CAPI_MESSAGING_MESSAGES_PUSH_MODULE
* @{
*/
-
+
/**
* @brief Called when an incoming push message is received.
+ * @since_tizen 2.3
*
- * @param[in] header The header of the push message
- * @param[in] body The body of the push message. (It's not a null-terminated string)
+ * @param[in] header The header of the push message
+ * @param[in] body The body of the push message \n
+ * It is not a null-terminated string.
* @param[in] body_length The length of @a body
- * @param[in] user_data The user data to be passed to the callback function
+ * @param[in] user_data The user data to be passed to the callback function
*
* @pre You register this callback using messages_push_set_incoming_cb() for getting an incoming message.
*
/**
- * @addtogroup CAPI_MESSAGING_MESSAGES_CB_MODULE
- * @{
- */
-
-/**
- * @brief The CB Message handle.
- */
-typedef struct messages_cb_message_s *messages_cb_message_h;
-
-/**
- * @brief The CB Settings handle.
- */
-typedef struct messages_cb_settings_s *messages_cb_settings_h;
-
- /**
- * @brief The CB Channel handle.
- */
-typedef struct messages_cb_channel_s *messages_cb_channel_h;
-
-/**
- * @brief Called when an incoming cb message is received.
- *
- * @param[in] msg The incoming CB message handle. \n
- This handle will be destroyed when exiting this callback function automatically.
- * @param[in] user_data The user data to be passed to the callback function
- *
- * @pre You register this callback using messages_cb_set_incoming_cb() for getting an incoming message.
- *
- * @see messages_cb_set_incoming_cb()
- * @see messages_cb_unset_incoming_cb()
- */
-typedef void (* messages_cb_incoming_cb)(messages_cb_message_h msg, void *user_data);
-
-
-/**
- * @brief Called when an incoming ETWS primary notification message is received.
- *
- * @details The ETWS primary notification message doesn't have text contents, but two parameters about ETWS are provided more. \n
- *
- * @remark The @a etws_security_info is 50 bytes binary data.
- *
- * @param[in] msg The incoming CB message handle. \n
- This handle will be destroyed when exiting this callback function automatically.
- * @param[in] etws_warning_type The ETWS warning type
- * @param[in] etws_security_info The ETWS security info (50 bytes binary data)
- * @param[in] user_data The user data to be passed to the callback function
- *
- * @pre You register this callback using messages_cb_set_incoming_cb() for getting an incoming message.
- *
- * @see messages_cb_set_etws_primary_noti_cb()
- * @see messages_cb_unset_etws_primary_noti_cb()
- */
-typedef void (* messages_cb_etws_primary_noti_cb)(messages_cb_message_h msg,
- int etws_warning_type, const char *etws_security_info, void *user_data);
-
-
-/**
- * @}
- */
-
-
-
-/**
* @}
*/
+++ /dev/null
-* Fri May 31 2013 Anas Nashif <anas.nashif@intel.com> accepted/tizen/20130520.100756@049c6e0
-- Remove placeholders and cleanup spec
-
+++ /dev/null
-<manifest>
- <request>
- <domain name="_"/>
- </request>
-</manifest>
Name: capi-messaging-messages
Summary: A SMS/MMS library in Tizen Native API
-Version: 0.1.25
+Version: 0.2.1
Release: 1
License: Apache-2.0
-Group: Messaging/API
Source0: %{name}-%{version}.tar.gz
-Source1001: capi-messaging-messages.manifest
-BuildRequires: cmake
-BuildRequires: pkgconfig(dlog)
-BuildRequires: pkgconfig(glib-2.0)
-BuildRequires: pkgconfig(msg-service)
-BuildRequires: pkgconfig(capi-base-common)
-BuildRequires: pkgconfig(capi-appfw-application)
+
+%if "%{?tizen_profile_name}" == "wearable"
+ExcludeArch: %{arm} %ix86 x86_64
+%endif
+
+BuildRequires: cmake
+BuildRequires: pkgconfig(dlog)
+BuildRequires: pkgconfig(glib-2.0)
+BuildRequires: pkgconfig(msg-service)
+BuildRequires: pkgconfig(capi-base-common)
+BuildRequires: pkgconfig(capi-appfw-application)
+BuildRequires: pkgconfig(capi-system-info)
+BuildRequires: pkgconfig(privacy-manager-client)
+Requires(post): /sbin/ldconfig
+Requires(postun): /sbin/ldconfig
%description
-A SMS/MMS library in Tizen Native API.
%package devel
Requires: %{name} = %{version}-%{release}
Requires: pkgconfig(msg-service)
Requires: pkgconfig(capi-base-common)
-Group: Development/Messaging
%description devel
-%devel_desc
+
+
%prep
%setup -q
-cp %{SOURCE1001} .
+
%build
MAJORVER=`echo %{version} | awk 'BEGIN {FS="."}{print $1}'`
rm -fr cmake_build_tmp; mkdir cmake_build_tmp
cd cmake_build_tmp
-%cmake .. -DFULLVER=%{version} -DMAJORVER=${MAJORVER}
+cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DFULLVER=%{version} -DMAJORVER=${MAJORVER}
make %{?jobs:-j%jobs}
%install
+rm -rf %{buildroot}
+
+mkdir -p %{buildroot}/usr/share/license
+cp LICENSE %{buildroot}/usr/share/license/%{name}
+
cd cmake_build_tmp
%make_install
%files
-%manifest %{name}.manifest
-%license LICENSE
%{_libdir}/libcapi-messaging-messages.so.*
+%{_datadir}/license/%{name}
+#%{_bindir}/*
%files devel
-%manifest %{name}.manifest
%{_includedir}/messaging/*.h
%{_libdir}/pkgconfig/*.pc
%{_libdir}/libcapi-messaging-messages.so
+
+
#include <glib.h>
-#include <dlog.h>
+#include <privacy_checker_client.h>
+
#include <msg.h>
#include <msg_transport.h>
#include <msg_storage.h>
#include <messages_types.h>
#include <messages_private.h>
-#ifdef LOG_TAG
-#undef LOG_TAG
-#endif
-#define LOG_TAG "CAPI_MESSAGING"
-#define DBG_MODE (1)
-
-#define MAX_MESSAGES_TEXT_LEN 1530
/* Private Utility Functions */
int _messages_get_media_type_from_filepath(const char *filepath);
int _messages_save_textfile(const char *text, char **filepath);
int _messages_load_textfile(const char *filepath, char **text);
void _messages_sent_mediator_cb(msg_handle_t handle, msg_struct_t pStatus, void *user_param);
-
-
+int _messages_check_feature(char *feature_name);
int messages_open_service(messages_service_h *svc)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int ret;
messages_service_s *_svc;
_svc->incoming_cb = NULL;
_svc->incoming_cb_enabled = false;
_svc->push_incoming_cb_list = NULL;
- _svc->cbs_enabled_cb = false;
- _svc->cbs_incoming_cb = NULL;
- _svc->cbs_incoming_cb_save = false;
- _svc->etws_incoming_cb = NULL;
- _svc->cbs_settings_h = NULL;
ret = msg_open_msg_handle(&_svc->service_h);
if (MSG_SUCCESS != ret) {
int messages_close_service(messages_service_h svc)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int ret;
messages_service_s *_svc = (messages_service_s *)svc;
- messages_cb_settings_s *_settings;
CHECK_NULL(_svc);
ret = msg_close_msg_handle(&_svc->service_h);
_svc->push_incoming_cb_list = NULL;
}
- if (_svc->cbs_settings_h) {
- _settings = (messages_cb_settings_s *)_svc->cbs_settings_h;
- _messages_cb_clear_settings(_settings);
- free(_settings);
- _svc->cbs_settings_h = NULL;
- }
-
free(svc);
return ERROR_CONVERT(ret);
int messages_create_message(messages_message_type_e type, messages_message_h *msg)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int ret;
messages_message_s *_msg = NULL;
}
else if (MESSAGES_TYPE_MMS == type)
{
+ ret = _messages_check_feature(MESSAGES_TELEPHONY_MMS_FEATURE);
+ if (MESSAGES_ERROR_NONE != ret) {
+ msg_release_struct(&_msg->msg_h);
+ free(_msg);
+ return ret;
+ }
+
ret = ERROR_CONVERT(msg_set_int_value(_msg->msg_h, MSG_MESSAGE_TYPE_INT, MSG_TYPE_MMS));
if (MESSAGES_ERROR_NONE != ret)
{
int messages_destroy_message(messages_message_h msg)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int ret;
messages_message_s *_msg = (messages_message_s*)msg;
int messages_get_message_type(messages_message_h msg, messages_message_type_e *type)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int msgType;
int ret;
int messages_add_address(messages_message_h msg, const char *address, messages_recipient_type_e type)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int ret;
messages_message_type_e msgType;
- msg_struct_list_s *addr_list = NULL;
msg_struct_t addr_info;
messages_message_s *_msg = (messages_message_s*)msg;
messages_get_message_type(msg, &msgType);
- ret = msg_get_list_handle(_msg->msg_h, MSG_MESSAGE_ADDR_LIST_STRUCT, (void **)&addr_list);
+ ret = msg_list_add_item(_msg->msg_h, MSG_MESSAGE_ADDR_LIST_HND, &addr_info);
if (MSG_SUCCESS != ret) {
return ERROR_CONVERT(ret);
}
- addr_info = addr_list->msg_struct_info[addr_list->nCount];
-
if (IS_SMS(msgType))
{
msg_set_int_value(addr_info, MSG_ADDRESS_INFO_RECIPIENT_TYPE_INT, MSG_RECIPIENTS_TYPE_TO);
return ERROR_CONVERT(ret);
}
- addr_list->nCount++;
-
return MESSAGES_ERROR_NONE;
}
int messages_get_address_count(messages_message_h msg, int *count)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int ret;
- msg_struct_list_s *addr_list = NULL;
+ msg_list_handle_t addr_list = NULL;
messages_message_s *_msg = (messages_message_s*)msg;
CHECK_NULL(_msg->msg_h);
CHECK_NULL(count);
- ret = msg_get_list_handle(_msg->msg_h, MSG_MESSAGE_ADDR_LIST_STRUCT, (void **)&addr_list);
+ ret = msg_get_list_handle(_msg->msg_h, MSG_MESSAGE_ADDR_LIST_HND, (void **)&addr_list);
if (MSG_SUCCESS != ret) {
return ERROR_CONVERT(ret);
}
- *count = addr_list->nCount;
+ *count = msg_list_length(addr_list);
return MESSAGES_ERROR_NONE;
}
int messages_get_address(messages_message_h msg, int index, char **address, messages_recipient_type_e *type)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int ret;
char _address[MAX_ADDRESS_VAL_LEN] = {0, };
int _type;
+ int count;
- msg_struct_list_s *addr_list = NULL;
+ msg_list_handle_t addr_list = NULL;
msg_struct_t addr_info;
messages_message_s *_msg = (messages_message_s*)msg;
CHECK_NULL(_msg->msg_h);
CHECK_NULL(address);
- ret = msg_get_list_handle(_msg->msg_h, MSG_MESSAGE_ADDR_LIST_STRUCT, (void **)&addr_list);
+ ret = msg_get_list_handle(_msg->msg_h, MSG_MESSAGE_ADDR_LIST_HND, (void **)&addr_list);
if (MSG_SUCCESS != ret) {
return ERROR_CONVERT(ret);
}
- if (index > addr_list->nCount)
+ count = msg_list_length(addr_list);
+ if (index > count)
{
LOGE("[%s] INVALID_PARAMETER(0x%08x) : index(%d) > addr_list->nCount(%d) "
- , __FUNCTION__, MESSAGES_ERROR_INVALID_PARAMETER, index, addr_list->nCount);
+ , __FUNCTION__, MESSAGES_ERROR_INVALID_PARAMETER, index, count);
return MESSAGES_ERROR_INVALID_PARAMETER;
}
- addr_info = addr_list->msg_struct_info[index];
+ addr_info = (msg_struct_t)msg_list_nth_data(addr_list, index);
ret = msg_get_str_value(addr_info, MSG_ADDRESS_INFO_ADDRESS_VALUE_STR, _address, MAX_ADDRESS_VAL_LEN);
if (MSG_SUCCESS != ret)
int messages_remove_all_addresses(messages_message_h msg)
{
- int ret;
- msg_struct_list_s *addr_list = NULL;
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+ int ret;
messages_message_s *_msg = (messages_message_s*)msg;
CHECK_NULL(_msg);
CHECK_NULL(_msg->msg_h);
- ret = msg_get_list_handle(_msg->msg_h, MSG_MESSAGE_ADDR_LIST_STRUCT, (void **)&addr_list);
- if (MSG_SUCCESS == ret)
- {
- addr_list->nCount = 0;
- }
+ ret = msg_list_clear(_msg->msg_h, MSG_MESSAGE_ADDR_LIST_HND);
return ERROR_CONVERT(ret);
}
int messages_send_message(messages_service_h svc, messages_message_h msg, bool save_to_sentbox,
messages_sent_cb callback, void *user_data)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
+ /* Privacy check */
+ int privacy_ret = privacy_checker_check_by_privilege(MESSAGES_PRIVILEGE_WRITE);
+ if (privacy_ret == PRIV_MGR_ERROR_USER_NOT_CONSENTED) {
+ return MESSAGES_ERROR_PERMISSION_DENIED;
+ }
+
int ret;
int reqId;
msg_struct_t req;
}
else if (IS_MMS(msgType))
{
+ ret = _messages_check_feature(MESSAGES_TELEPHONY_MMS_FEATURE);
+ if (MESSAGES_ERROR_NONE != ret) {
+ msg_release_struct(&sendOpt);
+ return ret;
+ }
+
ret = _messages_save_mms_data(_msg);
if (MESSAGES_ERROR_NONE == ret)
{
else
{
LOGE("[%s] INVALID_PARAMETER(0x%08x) : Invalid Message Type.",
- __FUNCTION__, TIZEN_ERROR_INVALID_PARAMETER);
+ __FUNCTION__, MESSAGES_ERROR_INVALID_PARAMETER);
msg_release_struct(&sendOpt);
- return TIZEN_ERROR_INVALID_PARAMETER;
+ return MESSAGES_ERROR_INVALID_PARAMETER;
}
msg_release_struct(&sendOpt);
messages_message_box_e mbox, messages_message_type_e type,
int *count)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int ret;
msg_folder_id_t folderId;
msg_struct_t countInfo = NULL;
int offset, int limit,
messages_message_h **message_array, int *length, int *total)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int i;
int ret;
msg_struct_list_s msg_list;
- msg_struct_t searchCon;
+ msg_struct_t listCond;
messages_message_type_e _msgType;
messages_service_s *_svc = (messages_service_s*)service;
CHECK_NULL(message_array);
// Set Condition
- searchCon = msg_create_struct(MSG_STRUCT_SEARCH_CONDITION);
- msg_set_int_value(searchCon, MSG_SEARCH_CONDITION_FOLDERID_INT, _messages_convert_mbox_to_fw(mbox));
- msg_set_int_value(searchCon, MSG_SEARCH_CONDITION_MSGTYPE_INT, _messages_convert_msgtype_to_fw(type));
+ listCond = msg_create_struct(MSG_STRUCT_MSG_LIST_CONDITION);
+
+ msg_set_int_value(listCond, MSG_LIST_CONDITION_FOLDER_ID_INT, _messages_convert_mbox_to_fw(mbox));
+ msg_set_int_value(listCond, MSG_LIST_CONDITION_MSGTYPE_INT, _messages_convert_msgtype_to_fw(type));
+
if (NULL != keyword)
{
- msg_set_str_value(searchCon, MSG_SEARCH_CONDITION_SEARCH_VALUE_STR, strdup(keyword), strlen(keyword));
+ msg_set_str_value(listCond, MSG_LIST_CONDITION_TEXT_VALUE_STR, strdup(keyword), strlen(keyword));
}
if (NULL != address)
{
- msg_set_str_value(searchCon, MSG_SEARCH_CONDITION_ADDRESS_VALUE_STR, strdup(address), strlen(address));
+ msg_set_str_value(listCond, MSG_LIST_CONDITION_ADDRESS_VALUE_STR, strdup(address), strlen(address));
}
// Search
- ret = msg_search_message(_svc->service_h, searchCon, offset, limit, &msg_list);
+ msg_set_bool_value(listCond, MSG_LIST_CONDITION_AND_OPERATER_BOOL, true);
+ msg_set_int_value(listCond, MSG_LIST_CONDITION_OFFSET_INT, offset);
+ msg_set_int_value(listCond, MSG_LIST_CONDITION_LIMIT_INT, limit);
+ ret = msg_get_message_list2(_svc->service_h, listCond, &msg_list);
if (MSG_SUCCESS != ret)
{
- msg_release_struct(&searchCon);
+ msg_release_struct(&listCond);
return ERROR_CONVERT(ret);
}
- msg_release_struct(&searchCon);
+ msg_release_struct(&listCond);
// Result
_array = (messages_message_h*)calloc(msg_list.nCount + 1, sizeof(messages_message_h));
int messages_free_message_array(messages_message_h *message_array)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int ret;
int i=0;
int offset, int limit,
messages_search_cb callback, void *user_data)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
+ /* Privacy check */
+ int privacy_ret = privacy_checker_check_by_privilege(MESSAGES_PRIVILEGE_READ);
+ if (privacy_ret == PRIV_MGR_ERROR_USER_NOT_CONSENTED) {
+ return MESSAGES_ERROR_PERMISSION_DENIED;
+ }
+
int i;
int ret;
bool ret_cb;
if (IS_MMS(msgType))
{
+ if (MESSAGES_ERROR_NONE != _messages_check_feature(MESSAGES_TELEPHONY_MMS_FEATURE)) {
+ free(_msg);
+ return;
+ }
+
_messages_load_mms_data(_msg, handle);
}
((messages_incoming_cb)_svc->incoming_cb)((messages_message_h)_msg, _svc->incoming_cb_user_data);
+ messages_mms_remove_all_attachments((messages_message_h)_msg);
free(_msg);
}
}
int messages_set_message_incoming_cb(messages_service_h svc, messages_incoming_cb callback, void *user_data)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int ret;
messages_service_s *_svc = (messages_service_s*)svc;
int messages_add_sms_listening_port(messages_service_h service, int port)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int ret;
messages_service_s *_svc = (messages_service_s*)service;
CHECK_NULL(_svc);
int messages_unset_message_incoming_cb(messages_service_h svc)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
messages_service_s *_svc = (messages_service_s*)svc;
CHECK_NULL(_svc);
_svc->incoming_cb_enabled = false;
+ _svc->incoming_cb = NULL;
+ _svc->incoming_cb_user_data = NULL;
return MESSAGES_ERROR_NONE;
}
int messages_get_message_port(messages_message_h msg, int *port)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int ret;
int _port;
int messages_set_text(messages_message_h msg, const char *text)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int ret;
int len;
messages_message_type_e type;
if (IS_SMS(type))
{
len = strlen(text);
- if (len > MAX_MESSAGES_TEXT_LEN)
+ if (len > MAX_MSG_TEXT_LEN)
{
LOGE("[%s] INVALID_PARAMETER(0x%08x) : the length of body exceeded the max, 1530 ."
, __FUNCTION__, MESSAGES_ERROR_INVALID_PARAMETER);
}
else if (IS_MMS(type))
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_MMS_FEATURE);
+
if (NULL != _msg->text)
{
free(_msg->text);
int messages_get_text(messages_message_h msg, char **text)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int ret;
char _text[MAX_MSG_TEXT_LEN];
messages_message_type_e type;
int messages_get_time(messages_message_h msg, time_t *time)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int ret;
int _time;
int messages_get_message_id(messages_message_h msg, int *msg_id)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int ret;
int _id;
return MESSAGES_ERROR_NONE;
}
+
+int messages_set_sim_id(messages_message_h msg, int sim_id)
+{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
+ int ret;
+
+ messages_message_s *_msg = (messages_message_s*)msg;
+ CHECK_NULL(_msg);
+ CHECK_NULL(_msg->msg_h);
+
+ ret = msg_set_int_value(_msg->msg_h, MSG_MESSAGE_SIM_INDEX_INT, sim_id);
+ if (MSG_SUCCESS != ret)
+ {
+ return ERROR_CONVERT(ret);
+ }
+
+ return MESSAGES_ERROR_NONE;
+}
+
+
+int messages_get_sim_id(messages_message_h msg, int *sim_id)
+{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
+ int ret;
+ int _id;
+
+ messages_message_s *_msg = (messages_message_s*)msg;
+ CHECK_NULL(_msg);
+ CHECK_NULL(_msg->msg_h);
+ CHECK_NULL(sim_id);
+
+ ret = msg_get_int_value(_msg->msg_h, MSG_MESSAGE_SIM_INDEX_INT, &_id);
+ if (MSG_SUCCESS != ret)
+ {
+ return ERROR_CONVERT(ret);
+ }
+
+ *sim_id = _id;
+
+ return MESSAGES_ERROR_NONE;
+}
+
+
int messages_search_message_by_id(messages_service_h service, int msg_id, messages_message_h *msg)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int ret;
msg_struct_t new_msg_h;
messages_message_type_e _msgType;
messages_get_message_type((messages_message_h)_msg, &_msgType);
if (IS_MMS(_msgType))
{
+ ret = _messages_check_feature(MESSAGES_TELEPHONY_MMS_FEATURE);
+ if (MESSAGES_ERROR_NONE != ret) {
+ free(_msg);
+ msg_release_struct(&new_msg_h);
+ return ret;
+ }
+
ret = _messages_load_mms_data(_msg, _svc->service_h);
if (MESSAGES_ERROR_NONE != ret) {
free(_msg);
int messages_get_mbox_type(messages_message_h msg, messages_message_box_e *mbox)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);
+
int ret;
int folder_id;
int messages_mms_set_subject(messages_message_h msg, const char *subject)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_MMS_FEATURE);
+
int ret;
messages_message_type_e type;
int messages_mms_get_subject(messages_message_h msg, char **subject)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_MMS_FEATURE);
+
int ret;
char _subject[MAX_SUBJECT_LEN];
messages_message_type_e type;
int messages_mms_add_attachment(messages_message_h msg, messages_media_type_e type, const char *path)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_MMS_FEATURE);
+
messages_message_type_e msg_type;
messages_message_s *_msg = (messages_message_s*)msg;
messages_attachment_s *attach;
+ int input_file_name_length;
CHECK_NULL(_msg);
CHECK_NULL(_msg->msg_h);
return MESSAGES_ERROR_INVALID_PARAMETER;
}
+ //CID 350148: Putting a check so that input buffer does not exceed max_size which will cause seg fault.
+ //CID 358513: Also putting this check before calloc of var attach to prevent memory leak in case of error.
+ input_file_name_length = strlen(path);
+ if(input_file_name_length > MSG_FILEPATH_LEN_MAX) {
+ LOGE("[%s] INVALID_PARAMETER(0x%08x) : maximum length of file_name_path can be %d"
+ , __FUNCTION__, MESSAGES_ERROR_INVALID_PARAMETER, MSG_FILEPATH_LEN_MAX);
+ return MESSAGES_ERROR_INVALID_PARAMETER;
+ }
+
// New Attach
attach = (messages_attachment_s *)calloc(1, sizeof(messages_attachment_s));
if (NULL == attach)
}
attach->media_type = type;
- strncpy(attach->filepath, path, strlen(path));
+
+ strncpy(attach->filepath, path, input_file_name_length);
// Append
_msg->attachment_list = g_slist_append(_msg->attachment_list, attach);
int messages_mms_get_attachment_count(messages_message_h msg, int *count)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_MMS_FEATURE);
+
messages_message_type_e type;
messages_message_s *_msg = (messages_message_s*)msg;
int messages_mms_get_attachment(messages_message_h msg, int index, messages_media_type_e *type, char **path)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_MMS_FEATURE);
+
messages_attachment_s *_attach;
messages_message_type_e msg_type;
int messages_mms_remove_all_attachments(messages_message_h msg)
{
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_MMS_FEATURE);
+
messages_message_s *_msg = (messages_message_s*)msg;
CHECK_NULL(_msg);
return MESSAGES_ERROR_NONE;
}
+
int _messages_save_mms_data(messages_message_s *msg)
{
int i;
if (NULL == image)
{
- msg_mms_add_item(mms_data, MSG_STRUCT_MMS_REGION, ®ion);
+ msg_list_add_item(mms_data, MSG_STRUCT_MMS_REGION, ®ion);
msg_set_str_value(region, MSG_MMS_REGION_ID_STR, (char *)"Text", 4);
msg_set_int_value(region, MSG_MMS_REGION_LENGTH_LEFT_INT, 0);
msg_set_int_value(region, MSG_MMS_REGION_LENGTH_TOP_INT, 0);
}
else if (NULL == msg->text)
{
- msg_mms_add_item(mms_data, MSG_STRUCT_MMS_REGION, ®ion);
+ msg_list_add_item(mms_data, MSG_STRUCT_MMS_REGION, ®ion);
msg_set_str_value(region, MSG_MMS_REGION_ID_STR, (char *)"Image", 5);
msg_set_int_value(region, MSG_MMS_REGION_LENGTH_LEFT_INT, 0);
msg_set_int_value(region, MSG_MMS_REGION_LENGTH_TOP_INT, 0);
}
else
{
- msg_mms_add_item(mms_data, MSG_STRUCT_MMS_REGION, ®ion);
+ msg_list_add_item(mms_data, MSG_STRUCT_MMS_REGION, ®ion);
msg_set_str_value(region, MSG_MMS_REGION_ID_STR, (char *)"Image", 5);
msg_set_int_value(region, MSG_MMS_REGION_LENGTH_LEFT_INT, 0);
msg_set_int_value(region, MSG_MMS_REGION_LENGTH_TOP_INT, 0);
msg_set_int_value(region, MSG_MMS_REGION_LENGTH_HEIGHT_INT, 50);
msg_set_int_value(region, MSG_MMS_REGION_BGCOLOR_INT, 0xffffff);
- msg_mms_add_item(mms_data, MSG_STRUCT_MMS_REGION, ®ion);
+ msg_list_add_item(mms_data, MSG_STRUCT_MMS_REGION, ®ion);
msg_set_str_value(region, MSG_MMS_REGION_ID_STR, (char *)"Text", 4);
msg_set_int_value(region, MSG_MMS_REGION_LENGTH_LEFT_INT, 0);
msg_set_int_value(region, MSG_MMS_REGION_LENGTH_TOP_INT, 50);
}
// Add Media
- msg_mms_add_item(mms_data, MSG_STRUCT_MMS_PAGE, &page);
+ msg_list_add_item(mms_data, MSG_STRUCT_MMS_PAGE, &page);
msg_set_int_value(page, MSG_MMS_PAGE_PAGE_DURATION_INT, 5440);
if (NULL != image)
{
if (MESSAGES_MEDIA_IMAGE == image->media_type)
{
- msg_mms_add_item(page, MSG_STRUCT_MMS_MEDIA, &media);
+ msg_list_add_item(page, MSG_STRUCT_MMS_MEDIA, &media);
msg_set_int_value(media, MSG_MMS_MEDIA_TYPE_INT, MMS_SMIL_MEDIA_IMG);
msg_set_str_value(media, MSG_MMS_MEDIA_REGION_ID_STR, (char *)"Image", 5);
msg_set_str_value(media, MSG_MMS_MEDIA_FILEPATH_STR, (char *)image->filepath, MSG_FILEPATH_LEN_MAX);
}
else if (MESSAGES_MEDIA_VIDEO == image->media_type)
{
- msg_mms_add_item(page, MSG_STRUCT_MMS_MEDIA, &media);
+ msg_list_add_item(page, MSG_STRUCT_MMS_MEDIA, &media);
msg_set_int_value(media, MSG_MMS_MEDIA_TYPE_INT, MMS_SMIL_MEDIA_VIDEO);
msg_set_str_value(media, MSG_MMS_MEDIA_REGION_ID_STR, (char *)"Image", 5);
msg_set_str_value(media, MSG_MMS_MEDIA_FILEPATH_STR, (char *)image->filepath, MSG_FILEPATH_LEN_MAX);
if (NULL != audio)
{
- msg_mms_add_item(page, MSG_STRUCT_MMS_MEDIA, &media);
+ msg_list_add_item(page, MSG_STRUCT_MMS_MEDIA, &media);
msg_set_int_value(media, MSG_MMS_MEDIA_TYPE_INT, MMS_SMIL_MEDIA_AUDIO);
msg_set_str_value(media, MSG_MMS_MEDIA_REGION_ID_STR, (char *)"Audio", 5);
msg_set_str_value(media, MSG_MMS_MEDIA_FILEPATH_STR, (char *)audio->filepath, MSG_FILEPATH_LEN_MAX);
ret = _messages_save_textfile(msg->text, &filepath);
if (MESSAGES_ERROR_NONE == ret)
{
- msg_mms_add_item(page, MSG_STRUCT_MMS_MEDIA, &media);
+ msg_list_add_item(page, MSG_STRUCT_MMS_MEDIA, &media);
msg_set_int_value(media, MSG_MMS_MEDIA_TYPE_INT, MMS_SMIL_MEDIA_TEXT);
msg_set_str_value(media, MSG_MMS_MEDIA_REGION_ID_STR, (char *)"Text", 4);
msg_set_str_value(media, MSG_MMS_MEDIA_FILEPATH_STR, (char *)filepath, MSG_FILEPATH_LEN_MAX);
attach = g_slist_nth_data(msg->attachment_list, i);
if (image != attach && audio != attach)
{
- msg_mms_add_item(mms_data, MSG_STRUCT_MMS_ATTACH, &mms_attach);
+ msg_list_add_item(mms_data, MSG_STRUCT_MMS_ATTACH, &mms_attach);
msg_set_str_value(mms_attach, MSG_MMS_ATTACH_FILEPATH_STR, (char *)attach->filepath, MSG_FILEPATH_LEN_MAX);
}
}
fclose(file);
return MESSAGES_ERROR_OPERATION_FAILED;
}
-
+
if (NULL == *text)
{
return ret;
}
-
int _messages_error_converter(int err, const char *func, int line)
{
switch(err)
func, line, MESSAGES_ERROR_NO_DATA, err);
return MESSAGES_ERROR_NO_DATA;
+ case MSG_ERR_PERMISSION_DENIED:
+ return MESSAGES_ERROR_PERMISSION_DENIED;
+
case MSG_SUCCESS:
return MESSAGES_ERROR_NONE;
}
}
+
+int _messages_check_feature(char *feature_name) {
+ bool is_supported = false;
+ if (!system_info_get_platform_bool(feature_name, &is_supported)) {
+ if (!is_supported) {
+ LOGE("[%s] feature is disabled", feature_name);
+ return MESSAGES_ERROR_NOT_SUPPORTED;
+ }
+ } else {
+ LOGE("Error - Feature getting from System Info");
+ return MESSAGES_ERROR_OPERATION_FAILED;
+ }
+ return MESSAGES_ERROR_NONE;
+}
+++ /dev/null
-/*
- * Copyright (c) 2011 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.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an AS IS BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-#include <sys/stat.h>
-#include <unistd.h>
-
-#include <stdio.h>
-#include <stdlib.h>
-#include <memory.h>
-
-#include <glib.h>
-
-#include <dlog.h>
-#include <msg.h>
-#include <msg_transport.h>
-#include <msg_storage.h>
-
-#include <messages.h>
-#include <messages_types.h>
-#include <messages_private.h>
-
-#ifdef LOG_TAG
-#undef LOG_TAG
-#endif
-#define LOG_TAG "CAPI_MESSAGING"
-
-
-
-void _messages_cb_incoming_mediator_cb(msg_handle_t handle, msg_struct_t msg, void *user_param)
-{
- int cbType;
- int etwsWarningType;
- char etwsWarningInfo[MESSAGES_ETWS_WARNING_INFO_LEN];
-
- messages_cb_message_s *_msg = NULL;
- messages_service_s *_svc = (messages_service_s*)user_param;
-
- if (NULL == _svc) {
- LOGW("[%s:%d] _svc is NULL.", __FUNCTION__, __LINE__);
- return;
- }
-
- if (NULL == msg) {
- LOGW("[%s:%d] msg is NULL.", __FUNCTION__, __LINE__);
- return;
- }
-
- if (_svc->etws_incoming_cb || _svc->cbs_incoming_cb)
- {
-
- _msg = (messages_cb_message_s *)calloc(1, sizeof(messages_message_s));
- if (NULL == _msg)
- {
- LOGE("[%s] OUT_OF_MEMORY(0x%08x) fail to create '_msg'."
- , __FUNCTION__, MESSAGES_ERROR_OUT_OF_MEMORY);
- return;
- }
-
- _msg->cb_msg_h = msg;
-
- msg_get_int_value(msg, MSG_CB_MSG_TYPE_INT, &cbType);
-
- if (MSG_TYPE_SMS_ETWS_PRIMARY == cbType)
- {
- if (_svc->etws_incoming_cb)
- {
- msg_get_int_value(msg, MSG_CB_MSG_ETWS_WARNING_TYPE_INT, &etwsWarningType);
- msg_get_str_value(msg, MSG_CB_MSG_ETWS_WARNING_SECU_INFO_STR, etwsWarningInfo, MESSAGES_ETWS_WARNING_INFO_LEN);
-
- ((messages_cb_etws_primary_noti_cb)_svc->etws_incoming_cb)((messages_cb_message_h)_msg, etwsWarningType, etwsWarningInfo, _svc->etws_incoming_cb_user_data);
- }
- }
- else {
- if (_svc->cbs_incoming_cb)
- {
- ((messages_cb_incoming_cb)_svc->cbs_incoming_cb)((messages_cb_message_h)_msg, _svc->cbs_incoming_cb_user_data);
- }
- }
-
- free(_msg);
- }
-}
-
-
-int messages_cb_get_message_id(messages_cb_message_h msg, int *msg_id)
-{
- int ret;
-
- messages_cb_message_s *_msg = (messages_cb_message_s *)msg;
-
- CHECK_NULL(_msg);
- CHECK_NULL(_msg->cb_msg_h);
- CHECK_NULL(msg_id);
-
- ret = msg_get_int_value(_msg->cb_msg_h, MSG_CB_MSG_MSG_ID_INT, msg_id);
-
- return ERROR_CONVERT(ret);
-}
-
-int messages_cb_get_serial_number(messages_cb_message_h msg, int *serial)
-{
- int ret;
-
- messages_cb_message_s *_msg = (messages_cb_message_s *)msg;
-
- CHECK_NULL(_msg);
- CHECK_NULL(_msg->cb_msg_h);
- CHECK_NULL(serial);
-
- ret = msg_get_int_value(_msg->cb_msg_h, MSG_CB_MSG_SERIAL_NUM_INT, serial);
-
- return ERROR_CONVERT(ret);
-}
-
-int messages_cb_get_dcs(messages_cb_message_h msg, int *dcs)
-{
- int ret;
-
- messages_cb_message_s *_msg = (messages_cb_message_s *)msg;
-
- CHECK_NULL(_msg);
- CHECK_NULL(_msg->cb_msg_h);
- CHECK_NULL(dcs);
-
- ret = msg_get_int_value(_msg->cb_msg_h, MSG_CB_MSG_DCS_INT, dcs);
-
- return ERROR_CONVERT(ret);
-}
-
-int messages_cb_get_message_type(messages_cb_message_h msg, messages_message_type_e *type)
-{
- int ret;
- int msgType;
-
- messages_cb_message_s *_msg = (messages_cb_message_s *)msg;
-
- CHECK_NULL(_msg);
- CHECK_NULL(_msg->cb_msg_h);
- CHECK_NULL(type);
-
- ret = msg_get_int_value(_msg->cb_msg_h, MSG_CB_MSG_TYPE_INT, &msgType);
- if (MSG_SUCCESS != ret)
- {
- return ERROR_CONVERT(ret);
- }
-
- switch (msgType)
- {
- case MSG_TYPE_SMS_ETWS_PRIMARY:
- *type = MESSAGES_TYPE_SMS_ETWS_PRIMARY;
- break;
- case MSG_TYPE_SMS_ETWS_SECONDARY:
- *type = MESSAGES_TYPE_SMS_ETWS_SECONDARY;
- break;
- default:
- *type = MESSAGES_TYPE_SMS_CB;
- break;
- }
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_get_language_type(messages_cb_message_h msg, char **type)
-{
- int ret;
- int len;
- char *_type;
-
- messages_cb_message_s *_msg = (messages_cb_message_s *)msg;
-
- CHECK_NULL(_msg);
- CHECK_NULL(_msg->cb_msg_h);
- CHECK_NULL(type);
-
- len = 15;
-
- _type = (char*)calloc(len + 1, sizeof(char)); // Maximum 15 bytes
- if (NULL == _type)
- {
- LOGE("[%s] OUT_OF_MEMORY(0x%08x) fail to create '_type'."
- , __FUNCTION__, MESSAGES_ERROR_OUT_OF_MEMORY);
- return MESSAGES_ERROR_OUT_OF_MEMORY;
- }
- ret = msg_get_str_value(_msg->cb_msg_h, MSG_CB_MSG_LANGUAGE_TYPE_STR, _type, len);
- if (MSG_SUCCESS != ret)
- {
- free(_type);
- return ERROR_CONVERT(ret);
- }
-
- *type = _type;
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_get_text(messages_cb_message_h msg, char **text)
-{
- int ret;
-
- int txtLen;
- int msgType;
- char *_text;
-
- messages_cb_message_s *_msg = (messages_cb_message_s *)msg;
-
- CHECK_NULL(_msg);
- CHECK_NULL(_msg->cb_msg_h);
- CHECK_NULL(text);
-
- ret = msg_get_int_value(_msg->cb_msg_h, MSG_CB_MSG_TYPE_INT, &msgType);
- if (MSG_SUCCESS != ret)
- {
- return ERROR_CONVERT(ret);
- }
-
- if (MSG_TYPE_SMS_ETWS_PRIMARY == msgType)
- {
- LOGE("[%s:%d] OPERATION_FAILED(0x%08x) : The type of msg is ETWS_PRIMARY. This msg doesn't have 'text'.",
- __FUNCTION__, __LINE__, MESSAGES_ERROR_OPERATION_FAILED);
- return MESSAGES_ERROR_OPERATION_FAILED;
- }
-
- ret = msg_get_int_value(_msg->cb_msg_h, MSG_CB_MSG_CB_TEXT_LEN_INT, &txtLen);
- if (MSG_SUCCESS != ret)
- {
- return ERROR_CONVERT(ret);
- }
-
- _text = (char *)calloc(txtLen + 1, sizeof(char));
- if (NULL == _text)
- {
- LOGE("[%s] OUT_OF_MEMORY(0x%08x) fail to create '_text'."
- , __FUNCTION__, MESSAGES_ERROR_OUT_OF_MEMORY);
- return MESSAGES_ERROR_OUT_OF_MEMORY;
- }
-
- ret = msg_get_str_value(_msg->cb_msg_h, MSG_CB_MSG_CB_TEXT_STR, _text, txtLen + 1);
- if (MSG_SUCCESS != ret)
- {
- free(_text);
- return ERROR_CONVERT(ret);
- }
-
- *text = _text;
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_get_time(messages_cb_message_h msg, time_t *time)
-{
- int ret;
- int _time;
-
- messages_cb_message_s *_msg = (messages_cb_message_s *)msg;
-
- CHECK_NULL(_msg);
- CHECK_NULL(_msg->cb_msg_h);
- CHECK_NULL(time);
-
- ret = msg_get_int_value(_msg->cb_msg_h, MSG_CB_MSG_RECV_TIME_INT, &_time);
- if (MSG_SUCCESS != ret)
- {
- return ERROR_CONVERT(ret);
- }
-
- *time = (time_t)_time;
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_set_incoming_cb(messages_service_h service, bool save,
- messages_cb_incoming_cb callback, void *user_data)
-{
- int ret;
-
- messages_service_s *_svc = (messages_service_s *)service;
-
- CHECK_NULL(_svc);
- CHECK_NULL(_svc->service_h);
- CHECK_NULL(callback);
-
- if (!_svc->cbs_enabled_cb)
- {
- ret = msg_reg_cb_message_callback(_svc->service_h, _messages_cb_incoming_mediator_cb, save, (void*)_svc);
- if (MSG_SUCCESS != ret)
- {
- return ERROR_CONVERT(ret);
- }
- _svc->cbs_enabled_cb = true;
- }
-
- _svc->cbs_incoming_cb = (void*)callback;
- _svc->cbs_incoming_cb_user_data = (void*)user_data;
- _svc->cbs_incoming_cb_save = save;
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_unset_incoming_cb(messages_service_h service)
-{
- messages_service_s *_svc = (messages_service_s *)service;
-
- CHECK_NULL(_svc);
-
- _svc->cbs_incoming_cb = NULL;
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_set_etws_primary_noti_cb(messages_service_h service,
- messages_cb_etws_primary_noti_cb callback, void *user_data)
-{
- int ret;
-
- messages_service_s *_svc = (messages_service_s *)service;
-
- CHECK_NULL(_svc);
- CHECK_NULL(_svc->service_h);
- CHECK_NULL(callback);
-
- if (!_svc->cbs_enabled_cb)
- {
- ret = msg_reg_cb_message_callback(_svc->service_h, _messages_cb_incoming_mediator_cb, _svc->cbs_incoming_cb_save, (void*)_svc);
- if (MSG_SUCCESS != ret)
- {
- return ERROR_CONVERT(ret);
- }
- _svc->cbs_enabled_cb = true;
- }
-
- _svc->etws_incoming_cb = (void*)callback;
- _svc->etws_incoming_cb_user_data = (void*)user_data;
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_unset_etws_primary_noti_cb(messages_service_h service)
-{
- messages_service_s *_svc = (messages_service_s *)service;
-
- CHECK_NULL(_svc);
-
- _svc->etws_incoming_cb = NULL;
-
- return MESSAGES_ERROR_NONE;
-}
-
-int _messages_cb_clear_settings(messages_cb_settings_s *settings)
-{
- CHECK_NULL(settings);
- CHECK_NULL(settings->_struct);
-
- msg_release_struct(&settings->_struct);
-
- if (settings->channel_list)
- {
- g_slist_foreach(settings->channel_list, (GFunc)g_free, NULL);
- g_slist_free(settings->channel_list);
- settings->channel_list = NULL;
- }
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_load_settings(messages_service_h service, messages_cb_settings_h *settings)
-{
- int i;
- int ret;
-
- messages_service_s *_svc = (messages_service_s *)service;
- messages_cb_settings_s * _settings;
-
- msg_struct_list_s *channels = NULL;
-
- messages_cb_channel_s *_ch;
-
- CHECK_NULL(_svc);
- CHECK_NULL(_svc->service_h);
- CHECK_NULL(settings);
-
- // Allocate Settings
- _settings = (messages_cb_settings_s *)calloc(1, sizeof(messages_cb_settings_s));
- if (NULL == _settings)
- {
- LOGE("[%s] OUT_OF_MEMORY(0x%08x) fail to create a '_settings'."
- , __FUNCTION__, MESSAGES_ERROR_OUT_OF_MEMORY);
- return MESSAGES_ERROR_OUT_OF_MEMORY;
- }
-
- // Load Settings
- _settings->_struct = msg_create_struct(MSG_STRUCT_SETTING_CB_OPT);
- ret = msg_get_cb_opt(_svc->service_h, _settings->_struct);
- if (MSG_SUCCESS != ret)
- {
- msg_release_struct(&_settings->_struct);
- free(_settings);
- return ERROR_CONVERT(ret);
- }
-
- // Load Channel List
- msg_get_list_handle(_settings->_struct, MSG_CB_CHANNEL_LIST_STRUCT, (void **)&channels);
- for (i=0; i < channels->nCount; i++)
- {
- _ch = (messages_cb_channel_s *)calloc(1, sizeof(messages_cb_channel_s));
- if (NULL == _ch)
- {
- LOGE("[%s] OUT_OF_MEMORY(0x%08x) fail to create '_ch'."
- , __FUNCTION__, MESSAGES_ERROR_OUT_OF_MEMORY);
- _messages_cb_clear_settings(_settings);
- free(_settings);
- return MESSAGES_ERROR_OUT_OF_MEMORY;
- }
-
- msg_get_bool_value(channels->msg_struct_info[i], MSG_CB_CHANNEL_ACTIVATE_BOOL, &_ch->activated);
- msg_get_int_value(channels->msg_struct_info[i], MSG_CB_CHANNEL_ID_FROM_INT, &_ch->from_id);
- msg_get_int_value(channels->msg_struct_info[i], MSG_CB_CHANNEL_ID_TO_INT, &_ch->to_id);
- msg_get_str_value(channels->msg_struct_info[i], MSG_CB_CHANNEL_NAME_STR, _ch->name, CB_CHANNEL_NAME_MAX);
-
- _settings->channel_list = g_slist_append(_settings->channel_list, (messages_cb_channel_h)_ch);
- }
-
- if (NULL != _svc->cbs_settings_h)
- {
- _messages_cb_clear_settings((messages_cb_settings_s*)_svc->cbs_settings_h);
- free(_svc->cbs_settings_h);
- }
- _svc->cbs_settings_h = (messages_cb_settings_h)_settings;
-
- *settings = (messages_cb_settings_h)_settings;
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_save_settings(messages_service_h service, messages_cb_settings_h settings)
-{
- int i;
- int count;
- int ret;
-
- messages_service_s *_svc = (messages_service_s *)service;
- messages_cb_settings_s *_settings = (messages_cb_settings_s *)settings;
-
- messages_cb_channel_s *_ch;
- msg_struct_list_s *channels = NULL;
-
- CHECK_NULL(_svc);
- CHECK_NULL(_svc->service_h);
- CHECK_NULL(_settings);
- CHECK_NULL(_settings->_struct);
-
- msg_get_list_handle(_settings->_struct, MSG_CB_CHANNEL_LIST_STRUCT, (void **)&channels);
-
- count = g_slist_length(_settings->channel_list);
- if (CB_CHANNEL_MAX < count)
- {
- count = CB_CHANNEL_MAX;
- }
- channels->nCount = count;
-
- for (i=0; i < channels->nCount; i++)
- {
- _ch = (messages_cb_channel_s *)g_slist_nth_data(_settings->channel_list, i);
-
- msg_set_bool_value(channels->msg_struct_info[i], MSG_CB_CHANNEL_ACTIVATE_BOOL, _ch->activated);
- msg_set_int_value(channels->msg_struct_info[i], MSG_CB_CHANNEL_ID_FROM_INT, _ch->from_id);
- msg_set_int_value(channels->msg_struct_info[i], MSG_CB_CHANNEL_ID_TO_INT, _ch->to_id);
- msg_set_str_value(channels->msg_struct_info[i], MSG_CB_CHANNEL_NAME_STR, _ch->name, CB_CHANNEL_NAME_MAX);
- }
-
- ret = msg_set_cb_opt(_svc->service_h, _settings->_struct);
-
- return ERROR_CONVERT(ret);
-}
-
-
-int messages_cb_settings_set_enabled(messages_cb_settings_h settings, bool enabled)
-{
- int ret;
- messages_cb_settings_s *_settings = (messages_cb_settings_s *)settings;
-
- CHECK_NULL(_settings);
- CHECK_NULL(_settings->_struct);
-
- ret = msg_set_bool_value(_settings->_struct, MSG_CB_RECEIVE_BOOL, enabled);
- if (MSG_SUCCESS != ret)
- {
- return ERROR_CONVERT(ret);
- }
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_settings_is_enabled(messages_cb_settings_h settings, bool *enabled)
-{
- int ret;
- bool _enabled;
- messages_cb_settings_s *_settings = (messages_cb_settings_s *)settings;
-
- CHECK_NULL(_settings);
- CHECK_NULL(_settings->_struct);
- CHECK_NULL(enabled);
-
- ret = msg_get_bool_value(_settings->_struct, MSG_CB_RECEIVE_BOOL, &_enabled);
- if (MSG_SUCCESS != ret)
- {
- return ERROR_CONVERT(ret);
- }
-
- *enabled = _enabled;
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_settings_add_channel(messages_cb_settings_h settings, messages_cb_channel_h channel)
-{
- int count;
-
- messages_cb_settings_s *_settings = (messages_cb_settings_s *)settings;
-
- CHECK_NULL(_settings);
- CHECK_NULL(channel);
-
- count = g_slist_length(_settings->channel_list);
- if (CB_CHANNEL_MAX <= count)
- {
- LOGE("[%s] OUT_OF_RANGE(0x%08x) channel_list is full."
- , __FUNCTION__, MESSAGES_ERROR_OUT_OF_MEMORY);
- return MESSAGES_ERROR_OUT_OF_RANGE;
- }
-
- _settings->channel_list = g_slist_append(_settings->channel_list, channel);
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_settings_remove_channel(messages_cb_settings_h settings, messages_cb_channel_h channel)
-{
- messages_cb_settings_s *_settings = (messages_cb_settings_s *)settings;
-
- CHECK_NULL(_settings);
- CHECK_NULL(channel);
-
- _settings->channel_list = g_slist_remove_all(_settings->channel_list, channel);
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_settings_get_channel(messages_cb_settings_h settings, int index, messages_cb_channel_h *channel)
-{
- messages_cb_channel_h ch;
- messages_cb_settings_s *_settings = (messages_cb_settings_s *)settings;
-
- CHECK_NULL(_settings);
- CHECK_NULL(channel);
-
- ch = (messages_cb_channel_h)g_slist_nth_data(_settings->channel_list, index);
- if (NULL == ch)
- {
- LOGE("[%s:%d] OPERATION_FAILED(0x%08x) : No channel data in the channel list.",
- __FUNCTION__, __LINE__, MESSAGES_ERROR_OPERATION_FAILED);
- return MESSAGES_ERROR_OPERATION_FAILED;
- }
-
- *channel = ch;
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_settings_get_channel_count(messages_cb_settings_h settings, int *count)
-{
- messages_cb_settings_s *_settings = (messages_cb_settings_s *)settings;
-
- CHECK_NULL(_settings);
- CHECK_NULL(count);
-
- *count = g_slist_length(_settings->channel_list);
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_create_channel(messages_cb_channel_h *channel)
-{
- messages_cb_channel_s *_channel;
-
- CHECK_NULL(channel);
-
- _channel = (messages_cb_channel_s *)calloc(1, sizeof(messages_cb_channel_s));
- if (NULL == _channel)
- {
- LOGE("[%s] OUT_OF_MEMORY(0x%08x) fail to create '_channel'."
- , __FUNCTION__, MESSAGES_ERROR_OUT_OF_MEMORY);
- return MESSAGES_ERROR_OUT_OF_MEMORY;
- }
-
- *channel = (messages_cb_channel_h)_channel;
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_destroy_channel(messages_cb_channel_h channel)
-{
- messages_cb_channel_s *_channel = (messages_cb_channel_s *)channel;
-
- CHECK_NULL(_channel);
-
- free(channel);
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_channel_set_id(messages_cb_channel_h channel, int from_id, int to_id)
-{
- messages_cb_channel_s *_channel = (messages_cb_channel_s *)channel;
-
- CHECK_NULL(_channel);
-
- _channel->from_id = from_id;
- _channel->to_id = to_id;
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_channel_get_id(messages_cb_channel_h channel, int *from_id, int *to_id)
-{
- messages_cb_channel_s *_channel = (messages_cb_channel_s *)channel;
-
- CHECK_NULL(_channel);
- CHECK_NULL(from_id);
- CHECK_NULL(to_id);
-
- *from_id = _channel->from_id;
- *to_id = _channel->to_id;
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_channel_set_name(messages_cb_channel_h channel, const char *name)
-{
- int size;
-
- messages_cb_channel_s *_channel = (messages_cb_channel_s *)channel;
-
- CHECK_NULL(_channel);
- CHECK_NULL(name);
-
- size = strlen(name);
-
- if (CB_CHANNEL_NAME_MAX < size)
- {
- LOGE("[%s] OUT_OF_RANGE(0x%08x) channel name > %d"
- , __FUNCTION__, MESSAGES_ERROR_OUT_OF_MEMORY, CB_CHANNEL_NAME_MAX);
- return MESSAGES_ERROR_OUT_OF_RANGE;
- }
-
- strncpy(_channel->name, name, CB_CHANNEL_NAME_MAX);
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_channel_get_name(messages_cb_channel_h channel, char **name)
-{
- messages_cb_channel_s *_channel = (messages_cb_channel_s *)channel;
-
- CHECK_NULL(_channel);
- CHECK_NULL(name);
-
- *name = strdup(_channel->name);
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_channel_set_activated(messages_cb_channel_h channel, bool activated)
-{
- messages_cb_channel_s *_channel = (messages_cb_channel_s *)channel;
-
- CHECK_NULL(_channel);
-
- _channel->activated = activated;
-
- return MESSAGES_ERROR_NONE;
-}
-
-int messages_cb_channel_is_activated(messages_cb_channel_h channel, bool *activated)
-{
- messages_cb_channel_s *_channel = (messages_cb_channel_s *)channel;
-
- CHECK_NULL(_channel);
- CHECK_NULL(activated);
-
- *activated = _channel->activated;
-
- return MESSAGES_ERROR_NONE;
-}
-
-
-
-
-
int messages_push_add_incoming_cb(messages_service_h service, const char *app_id, \r
messages_push_incoming_cb callback, void *user_data)\r
{\r
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);\r
+\r
int ret;\r
messages_push_incoming_callback_s *_cb;\r
\r
\r
int messages_push_remove_incoming_cb(messages_service_h service, const char *app_id)\r
{\r
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);\r
+\r
int i;\r
messages_push_incoming_callback_s *_cb;\r
\r
\r
int messages_push_register(messages_service_h service, const char *content_type, const char *app_id)\r
{\r
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);\r
+\r
int ret;\r
\r
msg_struct_t push_info;\r
CHECK_NULL(content_type);\r
CHECK_NULL(app_id);\r
\r
- ret = app_get_package(&pkg_name);\r
+ ret = app_get_id(&pkg_name);\r
if (APP_ERROR_NONE != ret) {\r
- LOGE("[%s:%d] OPERATION_FAILED(0x%08x) : app_get_package failed.", \r
+ LOGE("[%s:%d] OPERATION_FAILED(0x%08x) : app_get_id failed.",\r
__FUNCTION__, __LINE__, MESSAGES_ERROR_OPERATION_FAILED);\r
return MESSAGES_ERROR_OPERATION_FAILED; \r
}\r
\r
int messages_push_deregister(messages_service_h service, const char *content_type, const char *app_id)\r
{\r
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);\r
+\r
int ret;\r
\r
msg_struct_t push_info;\r
CHECK_NULL(content_type);\r
CHECK_NULL(app_id);\r
\r
- ret = app_get_package(&pkg_name);\r
+ ret = app_get_id(&pkg_name);\r
if (APP_ERROR_NONE != ret) {\r
- LOGE("[%s:%d] OPERATION_FAILED(0x%08x) : app_get_package failed.", \r
+ LOGE("[%s:%d] OPERATION_FAILED(0x%08x) : app_get_id failed.",\r
__FUNCTION__, __LINE__, MESSAGES_ERROR_OPERATION_FAILED);\r
return MESSAGES_ERROR_OPERATION_FAILED; \r
}\r
int messages_push_reregister(messages_service_h service, const char *content_type, const char *app_id,\r
const char *dst_content_type, const char *dst_app_id)\r
{\r
+ CHECK_MESSAGES_SUPPORTED(MESSAGES_TELEPHONY_FEATURE);\r
+\r
int ret;\r
\r
msg_struct_t push_info;\r
CHECK_NULL(dst_content_type);\r
CHECK_NULL(dst_app_id);\r
\r
- ret = app_get_package(&pkg_name);\r
+ ret = app_get_id(&pkg_name);\r
if (APP_ERROR_NONE != ret) {\r
- LOGE("[%s:%d] OPERATION_FAILED(0x%08x) : app_get_package failed.", \r
+ LOGE("[%s:%d] OPERATION_FAILED(0x%08x) : app_get_id failed.",\r
__FUNCTION__, __LINE__, MESSAGES_ERROR_OPERATION_FAILED);\r
return MESSAGES_ERROR_OPERATION_FAILED; \r
}\r
SET(fw_test "${fw_name}-test")
+SET(CMAKE_SKIP_BUILD_RPATH TRUE)
+
INCLUDE(FindPkgConfig)
pkg_check_modules(${fw_test} REQUIRED glib-2.0)
FOREACH(flag ${${fw_test}_CFLAGS})
MESSAGE("${src_name}")
ADD_EXECUTABLE(${src_name} ${src})
TARGET_LINK_LIBRARIES(${src_name} ${fw_name} ${${fw_test}_LDFLAGS})
+
+# INSTALL(TARGETS ${src_name} DESTINATION bin)
ENDFOREACH()
+++ /dev/null
-#include <stdio.h>
-#include <stdlib.h>
-
-#include <messages.h>
-
-int main(int argc, char *argv[])
-{
- int ret;
-
- messages_service_h svc;
-
- messages_cb_settings_h settings;
-
-
-
- // open service
- ret = messages_open_service(&svc);
- if (MESSAGES_ERROR_NONE != ret) {
- printf("error: messages_open_service() = %d", ret);
- return 1;
- }
-
- ret = messages_cb_load_settings(svc, &settings);
- if (MESSAGES_ERROR_NONE != ret) {
- printf("error: messages_cb_load_settings() = %d", ret);
- return 1;
- }
-
-
-
-
- // close service
- messages_close_service(svc);
-
-
- return 0;
-}
messages_message_type_e msgType;
messages_message_box_e mbox;
int ret;
+ int cnt;
char *text;
int i, nAddr;
char *addr = NULL;
printf("Subject: %s\n", text);
free(text);
}
+
+ ret = messages_mms_get_attachment_count(msg, &cnt);
+ if (MESSAGES_ERROR_NONE == ret) {
+ printf("Attachments: %d\n", cnt);
+ }
} else {
printf("Type: Unknown");
}
#include <stdio.h>
#include <stdlib.h>
+#include <glib.h>
+
#include <messages.h>
-#define TEST_NUMBER "000000000"
+//#define TEST_NUMBER "splusa2012@gmail.com"
+#define TEST_NUMBER "+491726597478"
+
+static GMainLoop *mainloop;
+
+static void sig_quit(int signo)
+{
+ if(mainloop)
+ {
+ g_main_loop_quit(mainloop);
+ }
+}
void _sent_cb(messages_sending_result_e result, void *user_data)
{
+ printf("sending result=%d\n", (int)result);
}
int main(int argc, char *argv[])
{
int ret;
+ signal(SIGINT, sig_quit);
+ signal(SIGTERM, sig_quit);
+ signal(SIGQUIT, sig_quit);
+ mainloop = g_main_loop_new(NULL, FALSE);
+
messages_service_h svc;
messages_message_h msg;
messages_set_text(msg, "This is a multi-media message!");
messages_mms_set_subject(msg, "TEST!");
-// messages_mms_add_attachment(msg, MESSAGES_MEDIA_VIDEO, "/opt/etc/msg-service/V091120_104905.3gp");
+// messages_mms_add_attachment(msg, MESSAGES_MEDIA_AUDIO, "/tmp/test.amr");
// messages_mms_add_attachment(msg, MESSAGES_MEDIA_IMAGE, "/opt/etc/msg-service/P091120_104633.jpg");
+ messages_mms_add_attachment(msg, MESSAGES_MEDIA_IMAGE, "/opt/media/Images/image2.jpg");
printf("Before Sending\n");
return 1;
}
+ g_main_loop_run(mainloop);
+ g_main_loop_unref(mainloop);
+
// destroy
messages_destroy_message(msg);
messages_close_service(svc);
#include <messages.h>
-#define TEST_NUMBER "00000000000"
+#define TEST_NUMBER "447810507326"
void _sent_cb(messages_sending_result_e result, void *user_data)
{
projects / platform / core / api / messages.git / commitdiff