summaryrefslogtreecommitdiff
path: root/include/mapi/msg_transport.h
diff options
context:
space:
mode:
Diffstat (limited to 'include/mapi/msg_transport.h')
-rwxr-xr-xinclude/mapi/msg_transport.h987
1 files changed, 987 insertions, 0 deletions
diff --git a/include/mapi/msg_transport.h b/include/mapi/msg_transport.h
new file mode 100755
index 0000000..a20b9ad
--- /dev/null
+++ b/include/mapi/msg_transport.h
@@ -0,0 +1,987 @@
+/*
+* Copyright 2012-2013 Samsung Electronics Co., Ltd
+*
+* Licensed under the Flora License, Version 1.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://floralicense.org
+*
+* 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.
+*/
+
+/**
+ * @file MapiTransport.h
+ * @brief Defines transport API of messaging framework
+ * @version 1.0
+ */
+
+#ifndef MAPI_TRANSPORT_H
+#define MAPI_TRANSPORT_H
+
+/**
+ * @section Introduction
+ * - Introduction : Overview on Messaging Transport API
+ * @section Program
+ * - Program : Messaging Transport API Reference
+ */
+
+/*==================================================================================================
+ INCLUDE FILES
+==================================================================================================*/
+
+#include "msg_transport_types.h"
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+/**
+ * @ingroup MESSAGING_FRAMEWORK
+ * @defgroup MESSAGING_TRANSPORT_API Messaging Transport API
+ * @{
+ */
+
+/*==================================================================================================
+ FUNCTION PROTOTYPES
+==================================================================================================*/
+
+/**
+
+ * \par Description:
+ * Submits a request to the Messaging Framework.
+ *
+ * \par Purpose:
+ * This API is used to submit a request to the Messaging Framework.
+ *
+ * \par Typical use case:
+ * Submit a request to Messaging Service such as Send Message, Forward etc.
+ *
+ * \par Method of function operation:
+ * Sets up the database connection and inserts the message to message table.
+ *
+ * \par Sync (or) Async:
+ * This is a Synchronous API.
+ *
+ * \par Important notes:
+ * - The result information will be sent back by using the callback function, msg_sent_status_cb.
+ * - Applications MUST fill in the valid message type.
+ * - reqId will be filled in the framework.
+ *
+ * \param input - handle is Message handle.
+ * \param input - req is a pointer to an MSG_REQUEST_S structure.
+ *
+ * \return Return Type (int(msg_error_t)) \n
+ * - MSG_SUCCESS Success in operation.
+ * - MSG_ERR_INVALID_MSGHANDLE Message handle is invalid.
+ * - MSG_ERR_NULL_POINTER Pointer is NULL.
+ *
+ * \par Prospective clients:
+ * External/Native Apps using Messaging Services.
+ *
+ * \par Related functions:
+ * None
+ *
+ * \par Known issues/bugs:
+ * None
+ *
+ * \par Sample code:
+ * \code
+ * ...
+ *
+ * int err = MSG_SUCCESS;
+ * MSG_REQUEST_S req;
+ *
+ * req.msg = msg;
+ * req.sendOpt = sendOpt;
+
+ * err = msg_submit_req(msgHandle, &req);
+ * if (err != MSG_SUCCESS)
+ * {
+ * ...
+ * }
+ *
+ * ...
+ * \endcode
+ */
+/*================================================================================================*/
+int msg_submit_req(msg_handle_t handle, msg_struct_t req);
+
+
+/**
+
+ * \par Description:
+ * Registers sent status callback function to Message handle.
+ *
+ * \par Purpose:
+ * This API is used to register sent status callback function "msg_sent_status_cb" to Message handle.
+ *
+ * \par Typical use case:
+ * Register for sent status callback.
+ *
+ * \par Method of function operation:
+ * Adds the msg_sent_status_cb API to sent status callback list.
+ *
+ * \par Sync (or) Async:
+ * This is a Synchronous API.
+ *
+ * \par Important notes:
+ * This function MUST be called after Message handle is opened.
+ *
+ * \param input - handle is Message handle.
+ * \param input - cb is a function to be called.
+ * \param input - user_param is a pointer to user data.
+ *
+ * \return Return Type (int(msg_error_t)) \n
+ * - MSG_SUCCESS Success in operation.
+ * - MSG_ERR_INVALID_MSGHANDLE Message handle is invalid.
+ *
+ * \par Prospective clients:
+ * External/Native Apps using Messaging Services.
+ *
+ * \par Related functions:
+ * None
+ *
+ * \par Known issues/bugs:
+ * None
+ *
+ * \par Sample code:
+ * \code
+ * ...
+ *
+ * int err = MSG_SUCCESS;
+ * MSG_REQUEST_S req;
+ *
+ * req.msg = msg;
+ * req.sendOpt = sendOpt;
+
+ * err = msg_reg_sent_status_callback(msgHandle, &sentStatusCB, (void*)"sent status callback");
+ * if (err != MSG_SUCCESS)
+ * {
+ * ...
+ * }
+ * return;
+ * }
+
+ * void sentStatusCB(msg_handle_t Handle, MSG_SENT_STATUS_S *pStatus, void *pUserParam)
+ * {
+ * ...
+ * }
+ * ...
+ * \endcode
+ */
+/*================================================================================================*/
+int msg_reg_sent_status_callback(msg_handle_t handle, msg_sent_status_cb cb, void *user_param);
+
+
+/**
+
+ * \par Description:
+ * Registers incoming SMS callback to Message handle.
+ *
+ * \par Purpose:
+ * This API is used to Registers incoming SMS callback function "msg_sms_incoming_cb" to Message handle.
+ *
+ * \par Typical use case:
+ * Register incoming SMS message callback.
+ *
+ * \par Method of function operation:
+ * Adds the msg_sms_incoming_cb API to incoming SMS callback list.
+ *
+ * \par Sync (or) Async:
+ * This is a Synchronous API.
+ *
+ * \par Important notes:
+ * This function MUST be called after Message handle is opened.
+ *
+ * \param input - handle is Message handle.
+ * \param input - cb is a function to be called.
+ * \param input - port is used for listening. If port is not used, please assign 0 to it.
+ * \param input - user_param is a pointer to user data.
+ *
+ * \return Return Type (int(msg_error_t)) \n
+ * - MSG_SUCCESS Success in operation.
+ * - MSG_ERR_INVALID_MSGHANDLE Message handle is invalid.
+ *
+ * \par Prospective clients:
+ * External/Native Apps using Messaging Services.
+ *
+ * \par Related functions:
+ * None
+ *
+ * \par Known issues/bugs:
+ * None
+ *
+ * \par Sample code:
+ * \code
+ * ...
+ *
+ * int err = MSG_SUCCESS;
+ * MSG_REQUEST_S req;
+ *
+ * req.msg = msg;
+ * req.sendOpt = sendOpt;
+
+ * err = msg_reg_sms_message_callback(msgHandle, &incomingSmsCB, 0, (void*)"sms message callback");
+ * if (err != MSG_SUCCESS)
+ * {
+ * ...
+ * }
+ * return;
+ * }
+ *
+ * void incomingSmsCB(msg_handle_t Handle, msg_message_t msg, void *pUserParam)
+ * {
+ * ...
+ * }
+ * ...
+ * \endcode
+ */
+/*================================================================================================*/
+int msg_reg_sms_message_callback(msg_handle_t handle, msg_sms_incoming_cb cb, unsigned short port, void *user_param);
+
+
+/**
+
+ * \par Description:
+ * Registers incoming MMS callback to Message handle.
+ *
+ * \par Purpose:
+ * This API is used to Registers incoming MMS callback function "msg_mms_conf_msg_incoming_cb" to Message handle.
+ *
+ * \par Typical use case:
+ * Register incoming SMS message callback.
+ *
+ * \par Method of function operation:
+ * Adds the msg_mms_conf_msg_incoming_cb API to incoming MMS callback list.
+ *
+ * \par Sync (or) Async:
+ * This is a Synchronous API.
+ *
+ * \par Important notes:
+ * This function MUST be called after Message handle is opened.
+ *
+ * \param input - handle is Message handle.
+ * \param input - handle is Message handle.
+ * \param input - cb is a function to be called.
+ * \param input - app_id is used for listening. If appId is not used, please assign NULL to it.
+ * \param input - user_param is a pointer to user data.
+ *
+ * \return Return Type (int(msg_error_t)) \n
+ * - MSG_SUCCESS Success in operation.
+ * - MSG_ERR_INVALID_MSGHANDLE Message handle is invalid.
+ *
+ * \par Prospective clients:
+ * External/Native Apps using Messaging Services.
+ *
+ * \par Related functions:
+ * None
+ *
+ * \par Known issues/bugs:
+ * None
+ *
+ * \par Sample code:
+ * \code
+ * ...
+ *
+ * int err = MSG_SUCCESS;
+ * MSG_REQUEST_S req;
+ *
+ * req.msg = msg;
+ * req.sendOpt = sendOpt;
+
+ * err = msg_reg_mms_conf_message_callback(msgHandle, &incomingMmsConfCB, NULL, NULL);
+ * if (err != MSG_SUCCESS)
+ * {
+ * ...
+ * }
+ * return;
+ * }
+ *
+ * void incomingMmsConfCB(msg_handle_t Handle, msg_message_t msg, void *pUserParam)
+ * {
+ * ...
+ * }
+ * ...
+ * \endcode
+ */
+/*================================================================================================*/
+int msg_reg_mms_conf_message_callback(msg_handle_t handle, msg_mms_conf_msg_incoming_cb cb, const char *app_id, void *user_param);
+
+
+/**
+
+ * \par Description:
+ * Registers incoming SyncML Message callback to Message handle.
+ *
+ * \par Purpose:
+ * This API is used to Registers incoming SyncML Message callback function "msg_syncml_msg_incoming_cb" to Message handle.
+ *
+ * \par Typical use case:
+ * Register incoming SMS message callback.
+ *
+ * \par Method of function operation:
+ * Adds the msg_syncml_msg_incoming_cb API to incoming SyncML callback list.
+ *
+ * \par Sync (or) Async:
+ * This is a Synchronous API.
+ *
+ * \par Important notes:
+ * This function MUST be called after Message handle is opened.
+ *
+ * \param input - handle is Message handle.
+ * \param input - cb is a function to be called.
+ * \param input - user_param is a pointer to user data.
+ *
+ * \return Return Type (int(msg_error_t)) \n
+ * - MSG_SUCCESS Success in operation.
+ * - MSG_ERR_MSGHANDLE_NOT_CONNECTED Message handle is not connected.
+ * - MSG_ERR_MEMORY_ERROR Memory is error.
+ *
+ * \par Prospective clients:
+ * External/Native Apps using Messaging Services.
+ *
+ * \par Related functions:
+ * None
+ *
+ * \par Known issues/bugs:
+ * None
+ *
+ * \par Sample code:
+ * \code
+ * ...
+ *
+ * int err = MSG_SUCCESS;
+ *
+ * err = err = msg_reg_syncml_message_callback(msgHandle, &syncMLCB, NULL);
+ * if (err != MSG_SUCCESS)
+ * {
+ * ...
+ * }
+ * return;
+ * }
+ *
+ * void syncMLCB(msg_handle_t hMsgHandle, msg_syncml_message_type_t msgType, const char* pPushHeader, int PushHeaderLen, const char* pPushBody, int PushBodyLen, void *pUserParam)
+ * {
+ * ...
+ * }
+ * ...
+ * \endcode
+ */
+/*================================================================================================*/
+int msg_reg_syncml_message_callback(msg_handle_t handle, msg_syncml_msg_incoming_cb cb, void *user_param);
+
+
+/**
+
+ * \par Description:
+ * Registers incoming LBS Message callback to Message handle.
+ *
+ * \par Purpose:
+ * This API is used to Registers incoming LBS Message callback function "msg_lbs_msg_incoming_cb" to Message handle.
+ *
+ * \par Typical use case:
+ * Register incoming SMS message callback.
+ *
+ * \par Method of function operation:
+ * Adds the msg_lbs_msg_incoming_cb API to incoming LBS Message callback list.
+ *
+ * \par Sync (or) Async:
+ * This is a Synchronous API.
+ *
+ * \par Important notes:
+ * This function MUST be called after Message handle is opened.
+ *
+ * \param input - handle is Message handle.
+ * \param input - cb is a function to be called.
+ * \param input - user_param is a pointer to user data.
+ *
+ * \return Return Type (int(msg_error_t)) \n
+ * - MSG_SUCCESS Success in operation.
+ * - MSG_ERR_MSGHANDLE_NOT_CONNECTED Message handle is not connected.
+ * - MSG_ERR_MEMORY_ERROR Memory is error.
+ *
+ * \par Prospective clients:
+ * External/Native Apps using Messaging Services.
+ *
+ * \par Related functions:
+ * None
+ *
+ * \par Known issues/bugs:
+ * None
+ *
+ * \par Sample code:
+ * \code
+ * ...
+ *
+ * int err = MSG_SUCCESS;
+ *
+ * err = msg_reg_lbs_message_callback(msgHandle, &lbsCB, NULL);
+ * if (err != MSG_SUCCESS)
+ * {
+ * ...
+ * }
+ * return;
+ * }
+ *
+ * void lbsCB(msg_handle_t hMsgHandle, const char* pPushHeader, const char* pPushBody, int pushBodyLen, void *pUserParam)
+ * {
+ * ...
+ * }
+ * ...
+ * \endcode
+ */
+/*================================================================================================*/
+int msg_reg_lbs_message_callback(msg_handle_t handle, msg_lbs_msg_incoming_cb cb, void *user_param);
+
+
+/**
+
+ * \par Description:
+ * Registers incoming LBS Message callback to Message handle.
+ *
+ * \par Purpose:
+ * This API is used to Registers incoming LBS Message callback function "msg_lbs_msg_incoming_cb" to Message handle.
+ *
+ * \par Typical use case:
+ * Register incoming SMS message callback.
+ *
+ * \par Method of function operation:
+ * Adds the msg_lbs_msg_incoming_cb API to incoming LBS Message callback list.
+ *
+ * \par Sync (or) Async:
+ * This is a Synchronous API.
+ *
+ * \par Important notes:
+ * This function MUST be called after Message handle is opened.
+ *
+ * \param input - handle is Message handle.
+ * \param input - cb is a function to be called.
+ * \param input - user_param is a pointer to user data.
+ *
+ * \return Return Type (int(msg_error_t)) \n
+ * - MSG_SUCCESS Success in operation.
+ * - MSG_ERR_MSGHANDLE_NOT_CONNECTED Message handle is not connected.
+ * - MSG_ERR_MEMORY_ERROR Memory is error.
+ *
+ * \par Prospective clients:
+ * External/Native Apps using Messaging Services.
+ *
+ * \par Related functions:
+ * None
+ *
+ * \par Known issues/bugs:
+ * None
+ *
+ * \par Sample code:
+ * \code
+ * ...
+ *
+ * int err = MSG_SUCCESS;
+ *
+ * err = msg_reg_lbs_message_callback(msgHandle, &lbsCB, NULL);
+ * if (err != MSG_SUCCESS)
+ * {
+ * ...
+ * }
+ * return;
+ * }
+ *
+ * void lbsCB(msg_handle_t hMsgHandle, const char* pPushHeader, const char* pPushBody, int pushBodyLen, void *pUserParam)
+ * {
+ * ...
+ * }
+ * ...
+ * \endcode
+ */
+/*================================================================================================*/
+int msg_reg_syncml_message_operation_callback(msg_handle_t handle, msg_syncml_msg_operation_cb cb, void *user_param);
+
+
+int msg_reg_push_message_callback(msg_handle_t handle, msg_push_msg_incoming_cb cb, const char *app_id, void *user_param);
+
+int msg_reg_cb_message_callback(msg_handle_t handle, msg_cb_incoming_cb cb, bool bsave, void *user_param);
+
+/**
+
+ * \par Description:
+ * Registers incoming LBS Message callback to Message handle.
+ *
+ * \par Purpose:
+ * This API is used to Registers incoming LBS Message callback function "msg_lbs_msg_incoming_cb" to Message handle.
+ *
+ * \par Typical use case:
+ * Register incoming SMS message callback.
+ *
+ * \par Method of function operation:
+ * Adds the msg_lbs_msg_incoming_cb API to incoming LBS Message callback list.
+ *
+ * \par Sync (or) Async:
+ * This is a Synchronous API.
+ *
+ * \par Important notes:
+ * This function MUST be called after Message handle is opened.
+ *
+ * \param input - handle is Message handle.
+ * \param input - cb is a function to be called.
+ * \param input - user_param is a pointer to user data.
+ *
+ * \return Return Type (int(msg_error_t)) \n
+ * - MSG_SUCCESS Success in operation.
+ * - MSG_ERR_MSGHANDLE_NOT_CONNECTED Message handle is not connected.
+ * - MSG_ERR_MEMORY_ERROR Memory is error.
+ *
+ * \par Prospective clients:
+ * External/Native Apps using Messaging Services.
+ *
+ * \par Related functions:
+ * None
+ *
+ * \par Known issues/bugs:
+ * None
+ *
+ * \par Sample code:
+ * \code
+ * ...
+ *
+ * int err = MSG_SUCCESS;
+ *
+ * err = msg_reg_lbs_message_callback(msgHandle, &lbsCB, NULL);
+ * if (err != MSG_SUCCESS)
+ * {
+ * ...
+ * }
+ * return;
+ * }
+ *
+ * void lbsCB(msg_handle_t hMsgHandle, const char* pPushHeader, const char* pPushBody, int pushBodyLen, void *pUserParam)
+ * {
+ * ...
+ * }
+ * ...
+ * \endcode
+ */
+/*================================================================================================*/
+int msg_syncml_message_operation(msg_handle_t handle, msg_message_id_t msgId);
+
+
+/**
+
+ * \par Description:
+ * Sends SMS. It is a synchronous API which has been blocked until sent status arrives.
+ *
+ * \par Purpose:
+ * This API is used to sends SMS.
+ *
+ * \par Typical use case:
+ * Sends a SMS Message
+ *
+ * \par Method of function operation:
+ * It is a synchronous API which has been blocked until sent status arrives.
+ *
+ * \par Sync (or) Async:
+ * This is a Synchronous API.
+ *
+ * \par Important notes:
+ * - None
+ *
+ * \param input - phone_num is the list of phone numbers. It is separated by ",".
+ * \param input - sms_text is a SMS text.
+ * \param input - cb is a function to be called.
+ * \param input - user_param is for user data.
+ *
+ * \return Return Type (int(msg_error_t)) \n
+ * - MSG_SUCCESS Success in operation.
+ * - MSG_ERR_NULL_POINTER Invalid parameter.
+ * - MSG_ERR_MEMORY_ERROR Memory is error.
+ *
+ * \par Prospective clients:
+ * External/Native Apps using Messaging Services.
+ *
+ * \par Related functions:
+ * None
+ *
+ * \par Known issues/bugs:
+ * None
+ *
+ * \par Sample code:
+ * \code
+ * ...
+ *
+ * int err = MSG_SUCCESS;
+ *
+ * err = msg_sms_send("01000000000,01000000000", "1234567890", sentStatusCB, NULL);
+ * if (err != MSG_SUCCESS)
+ * {
+ * ...
+ * }
+ *
+ * ...
+ * \endcode
+ */
+/*================================================================================================*/
+int msg_sms_send(const char *phone_num, const char *sms_text, msg_simple_sent_status_cb cb, void *user_param);
+
+
+/**
+
+ * \par Description:
+ * Submits request to send SMS message.
+ *
+ * \par Purpose:
+ * This API is used to submit request to send SMS message.
+ *
+ * \par Typical use case:
+ * Submits request to send SMS message.
+ *
+ * \par Method of function operation:
+ * Submits a request to send SMS.
+ *
+ * \par Sync (or) Async:
+ * This is a Synchronous API.
+ *
+ * \par Important notes:
+ * - None
+ *
+ * \param input - phone_num is the list of phone numbers. It is separated by ",".
+ * \param input - sms_text is a SMS text.
+ * \param input - cb is a function to be called.
+ * \param input - user_param is for user data.
+ *
+ * \return Return Type (int(msg_error_t)) \n
+ * - MSG_SUCCESS Success in operation.
+ * - MSG_ERR_NULL_POINTER Invalid parameter.
+ * - MSG_ERR_MEMORY_ERROR Memory is error.
+ *
+ * \par Prospective clients:
+ * External/Native Apps using Messaging Services.
+ *
+ * \par Related functions:
+ * None
+ *
+ * \par Known issues/bugs:
+ * None
+ *
+ * \par Sample code:
+ * \code
+ * ...
+ *
+ * int err = MSG_SUCCESS;
+ * MSG_REQUEST_S req;
+ *
+ * req.msg = msg;
+ * req.sendOpt = sendOpt;
+ *
+ * err = msg_sms_send_message(msgHandle, &req);
+ * if (err != MSG_SUCCESS)
+ * {
+ * ...
+ * }
+ *
+ * ...
+ * \endcode
+ */
+/*================================================================================================*/
+int msg_sms_send_message(msg_handle_t handle, msg_struct_t req);
+
+
+/**
+
+ * \par Description:
+ * Submits request to send MMS message.
+ *
+ * \par Purpose:
+ * This API is used to submit request to send MMS message.
+ *
+ * \par Typical use case:
+ * Submits request to send MMS message.
+ *
+ * \par Method of function operation:
+ * Submits a request to send MMS.
+ *
+ * \par Sync (or) Async:
+ * This is a Synchronous API.
+ *
+ * \par Important notes:
+ * - None
+ *
+ * \param input - handle is Message handle.
+ * \param input - req is a pointer to an MSG_REQUEST_S structure.
+ *
+ * \return Return Type (int(msg_error_t)) \n
+ * - MSG_SUCCESS Success in operation.
+ * - MSG_ERR_NULL_POINTER Invalid parameter.
+ * - MSG_ERR_MEMORY_ERROR Memory is error.
+ *
+ * \par Prospective clients:
+ * External/Native Apps using Messaging Services.
+ *
+ * \par Related functions:
+ * None
+ *
+ * \par Known issues/bugs:
+ * None
+ *
+ * \par Sample code:
+ * \code
+ * ...
+ *
+ * int err = MSG_SUCCESS;
+ * MSG_REQUEST_S req;
+ *
+ * req.msg = msg;
+ * req.sendOpt = sendOpt;
+ *
+ * err = msg_mms_send_message(msgHandle, &req);
+ * if (err != MSG_SUCCESS)
+ * {
+ * ...
+ * }
+ *
+ * ...
+ * \endcode
+ */
+/*================================================================================================*/
+int msg_mms_send_message(msg_handle_t handle, msg_struct_t req);
+
+
+/**
+
+ * \par Description:
+ * Submits request to send MMS read report request.
+ *
+ * \par Purpose:
+ * This API is used to submit request to send MMS read report request.
+ *
+ * \par Typical use case:
+ * Submits request to send MMS read report request.
+ *
+ * \par Method of function operation:
+ * Submits a request to send MMS read report request.
+ *
+ * \par Sync (or) Async:
+ * This is a Synchronous API.
+ *
+ * \par Important notes:
+ * - None
+ *
+ * \param input - handle is Message handle.
+ * \param input - msg_id is a message id, which is a positive integer.
+ * \param input - mms_read_status is status whether message was read or not.
+ *
+ * \return Return Type (int(msg_error_t)) \n
+ * - MSG_SUCCESS Success in operation.
+ * - MSG_ERR_NULL_POINTER Invalid parameter.
+ * - MSG_ERR_MEMORY_ERROR Memory is error.
+ *
+ * \par Prospective clients:
+ * External/Native Apps using Messaging Services.
+ *
+ * \par Related functions:
+ * None
+ *
+ * \par Known issues/bugs:
+ * None
+ *
+ * \par Sample code:
+ * \code
+ * ...
+ *
+ * int err = MSG_SUCCESS;
+ *
+ * err = err = msg_mms_send_read_report(NULL, 0, MSG_READ_REPORT_IS_READ);
+ * if (err != MSG_SUCCESS)
+ * {
+ * ...
+ * }
+ *
+ * ...
+ * \endcode
+ */
+/*================================================================================================*/
+int msg_mms_send_read_report(msg_handle_t handle, msg_message_id_t msgId, msg_read_report_status_t mms_read_status);
+
+
+/**
+
+ * \par Description:
+ * Submits request to send forward MMS request.
+ *
+ * \par Purpose:
+ * This API is used to submit request to send forward MMS request.
+ *
+ * \par Typical use case:
+ * Submits request to send forward MMS request.
+ *
+ * \par Method of function operation:
+ * Submits a request to send forward MMS request.
+ *
+ * \par Sync (or) Async:
+ * This is a Synchronous API.
+ *
+ * \par Important notes:
+ * - None
+ *
+ * \param input - handle is Message handle.
+ * \param input - req is a pointer to an MSG_REQUEST_S structure.
+ *
+ * \return Return Type (int(msg_error_t)) \n
+ * - MSG_SUCCESS Success in operation.
+ * - MSG_ERR_INVALID_MSGHANDLE Message handle is invalid.
+ * - MSG_ERR_NULL_POINTER Pointer is NULL.
+ *
+ * \par Prospective clients:
+ * External/Native Apps using Messaging Services.
+ *
+ * \par Related functions:
+ * None
+ *
+ * \par Known issues/bugs:
+ * None
+ *
+ * \par Sample code:
+ * \code
+ * ...
+ *
+ * int err = MSG_SUCCESS;
+ *
+ * err = err = msg_mms_send_read_report(NULL, 0, MSG_READ_REPORT_IS_READ);
+ * if (err != MSG_SUCCESS)
+ * {
+ * ...
+ * }
+ *
+ * ...
+ * \endcode
+ */
+/*================================================================================================*/
+int msg_mms_forward_message(msg_handle_t handle, msg_struct_t req);
+
+
+/**
+
+ * \par Description:
+ * Submits request to retrieve MMS request.
+ *
+ * \par Purpose:
+ * This API is used to submit request to retrieve MMS request.
+ *
+ * \par Typical use case:
+ * Submits request to retrieve MMS request.
+ *
+ * \par Method of function operation:
+ * Submits a request to send forward MMS request.
+ *
+ * \par Sync (or) Async:
+ * This is a Synchronous API.
+ *
+ * \par Important notes:
+ * - None
+ *
+ * \param input - handle is Message handle.
+ * \param input - req is a pointer to an MSG_REQUEST_S structure.
+ *
+ * \return Return Type (int(msg_error_t)) \n
+ * - MSG_SUCCESS Success in operation.
+ * - MSG_ERR_INVALID_MSGHANDLE Message handle is invalid.
+ * - MSG_ERR_NULL_POINTER Pointer is NULL.
+ *
+ * \par Prospective clients:
+ * External/Native Apps using Messaging Services.
+ *
+ * \par Related functions:
+ * None
+ *
+ * \par Known issues/bugs:
+ * None
+ *
+ * \par Sample code:
+ * \code
+ * ...
+ *
+ * int err = MSG_SUCCESS;
+ *
+ * err = msg_mms_retrieve_message(handle, &req);
+ * if (err != MSG_SUCCESS)
+ * {
+ * ...
+ * }
+ *
+ * ...
+ * \endcode
+ */
+/*================================================================================================*/
+int msg_mms_retrieve_message(msg_handle_t handle, msg_struct_t req);
+
+
+/* reject_msg_support */
+/**
+
+ * \par Description:
+ * Submits request to reject MMS message.
+ *
+ * \par Purpose:
+ * This API is used to submit request to reject MMS message.
+ *
+ * \par Typical use case:
+ * Submits request to reject MMS message.
+ *
+ * \par Method of function operation:
+ * Submits a request to send forward reject MMS message.
+ *
+ * \par Sync (or) Async:
+ * This is a Synchronous API.
+ *
+ * \par Important notes:
+ * - None
+ *
+ * \param input - handle is Message handle.
+ * \param input - req is a pointer to an MSG_REQUEST_S structure.
+ *
+ * \return Return Type (int(msg_error_t)) \n
+ * - MSG_SUCCESS Success in operation.
+ * - MSG_ERR_INVALID_MSGHANDLE Message handle is invalid.
+ * - MSG_ERR_NULL_POINTER Pointer is NULL.
+ *
+ * \par Prospective clients:
+ * External/Native Apps using Messaging Services.
+ *
+ * \par Related functions:
+ * None
+ *
+ * \par Known issues/bugs:
+ * None
+ *
+ * \par Sample code:
+ * \code
+ * ...
+ *
+ * int err = MSG_SUCCESS;
+ *
+ * err = msg_mms_reject_message(handle, &req);
+ * if (err != MSG_SUCCESS)
+ * {
+ * ...
+ * }
+ *
+ * ...
+ * \endcode
+ */
+/*================================================================================================*/
+int msg_mms_reject_message(msg_handle_t handle, msg_struct_t req);
+
+/**
+ * @}
+ */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // MAPI_TRANSPORT_H
+