Adding New MMS SearchMsg/GetMsgCount() apis in Tizen::Messaging::MmsMessage/MmsManage...

Change-Id: Ie017a2789d3af0e41fccbefd8f6071119c0bcf3d
Signed-off-by: shivajm <shiva.jm@samsung.com>

diff --git a/inc/FMsgMmsManager.h b/inc/FMsgMmsManager.h
index 38b6bed..fc8bd92 100755 (executable)
--- a/inc/FMsgMmsManager.h
+++ b/inc/FMsgMmsManager.h
@@ -140,7 +140,7 @@ namespace Tizen { namespace Messaging
                * @param[in]    listener                                The listener to receive the sent result asynchronously
                * @exception    E_SUCCESS                               The method is successful.
                * @exception    E_OUT_OF_MEMORY                 The memory is insufficient.
-               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
+               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
                *                                                                               For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
                * @remarks      Before calling this method, check whether the feature is supported by
                *                       Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
@@ -174,8 +174,8 @@ namespace Tizen { namespace Messaging
                *                                                                       - The message is empty.
                * @exception    E_MAX_EXCEEDED                  The number of recipients has crossed the maximum limit (Maximum 10).
                * @exception    E_PRIVILEGE_DENIED      The application does not have the privilege to call this method.
-               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method. @b Since: @b 2.1
-               * @remarks              
+               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method.
+               * @remarks
                *                       - Some service providers may not support sending MMS messages with an empty subject or body. @n
                *                       In this case, the result of the status report is the @c E_FAILURE exception.
                *                       - The CC and BCC recipients in the @c recipientList are merged with the TO recipients when sending an MMS message.
@@ -183,6 +183,83 @@ namespace Tizen { namespace Messaging
                */
                result Send(const MmsMessage& message, const RecipientList& recipientList, bool saveToSentbox);
 
+          /**
+               * Gets the total number of MMS messages in the specified message box.
+               *
+               * @since                3.0
+               * @privlevel    public
+               * @privilege    %http://tizen.org/privilege/messaging.read @n
+               *
+               * @return               The total number of MMS messages in the specified message box
+               * @param[in]    type                                    The message box type
+               * @exception    E_SUCCESS                               The method is successful.
+               * @exception    E_INVALID_ARG                   The specified @c type is invalid.
+               * @exception    E_SYSTEM                                A system error has occurred.
+               * @exception    E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
+               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method.
+               * @remarks
+               *                       - In case of an error, this method returns a negative value. For example, @c -1.
+               *                       - The specific error code can be accessed using the GetLastResult() method.
+               */
+               int GetTotalMessageCount(MmsMessageBoxType type) const;
+
+          /**
+               * Searches the MMS messages by keyword in the specified message box.
+               *
+               * @since                3.0
+               * @privlevel    public
+               * @privilege    %http://tizen.org/privilege/messaging.read @n
+               *
+               * @return               A pointer to the list of MmsMessage instances
+               * @param[in]    type                                    The type of message box
+               * @param[in]    pKeyword                                A part of the body text as a keyword (partial match) @n
+               *                                                                       In case of @c null or an empty string, this method searches all the MMS messages in the specified message box.
+               * @param[in]    offset                          The offset of the searched results (base 0)
+               * @param[in]    maxCount                        The maximum count of SMS messages to search
+               * @param[out]   totalResultCount                The total count of the searched result
+               * @exception    E_SUCCESS                       The method is successful.
+               * @exception    E_INVALID_ARG           Either of the following conditions has occurred:
+               *                                                               - The specified @c type is invalid.
+               *                                                               - The specified @c pKeyword string length is less than @c 2.
+               *                                                               - The specified @c pKeyword string length is greater than @c 30.
+               *                                                               - The specified @c offset value is less than @c 0.
+               *                                                               - The specified @c maxCount value is less than @c 0.
+               * @exception    E_OUT_OF_MEMORY                 The memory is insufficient.
+               * @exception    E_SYSTEM                                A system error has occurred.
+               * @exception    E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
+               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method.
+               * @remarks
+               *                               - The specific error code can be accessed using the GetLastResult() method.
+               *                               - The search with the specified keywords uses only the first 50 characters of the body text.
+               */
+               Tizen::Base::Collection::IList* SearchMessageBoxN(MmsMessageBoxType type, const Tizen::Base::String* pKeyword, int offset, int maxCount, int& totalResultCount) const;
+
+          /**
+               * Searches all the MMS messages by keyword in the specified message box.
+               *
+               * @since                3.0
+               * @privlevel    public
+               * @privilege    %http://tizen.org/privilege/messaging.read @n
+               *
+               * @return               A pointer to the IEnumerator object, which contains list of searched MmsMessage instances
+               * @param[in]    type                                    The type of message box
+               * @param[in]    pKeyword                                A part of the body text as a keyword (partial match) @n
+               *                                                               In case of @c null or an empty string, this method searches all the MMS messages in the specified message box.
+               * @exception    E_SUCCESS                       The method is successful.
+               * @exception    E_INVALID_ARG           Either of the following conditions has occurred:
+               *                                                               - The specified @c type is invalid.
+               *                                                               - The specified @c pKeyword string length is less than @c 2.
+               *                                                               - The specified @c pKeyword string length is greater than @c 30.
+               * @exception    E_OUT_OF_MEMORY                 The memory is insufficient.
+               * @exception    E_SYSTEM                                A system error has occurred.
+               * @exception    E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
+               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method.
+               * @remarks
+               *                               - The specific error code can be accessed using the GetLastResult() method.
+               *                               - The search with the specified keywords uses only the first 50 characters of the body text.
+               */
+               Tizen::Base::Collection::IEnumerator* SearchMessageBoxN(MmsMessageBoxType type, const Tizen::Base::String* pKeyword) const;
+
        private:
                _MmsManagerImpl* __pImpl;
 

diff --git a/inc/FMsgMmsMessage.h b/inc/FMsgMmsMessage.h
index 7e94fa0..526e033 100755 (executable)
--- a/inc/FMsgMmsMessage.h
+++ b/inc/FMsgMmsMessage.h
@@ -217,6 +217,23 @@ namespace Tizen { namespace Messaging
                */
                result RemoveAttachment(MmsAttachmentFormat format);
 
+               /**
+               * Gets the unique ID of an MMS message.
+               *
+               * @since                3.0
+               * @privlevel    public
+               * @privilege    %http://tizen.org/privilege/messaging.read @n
+               *
+               * @return               The unique ID of the MMS message @n
+               *                               The value is a negative value in case of an error. For example, @c -1.
+               * @exception    E_SUCCESS                               The method is successful.
+               * @exception    E_INVALID_OPERATION             This operation is allowed only when the message is from the Inbox, Sentbox, or Outbox.
+               * @exception    E_PRIVILEGE_DENIED      The application does not have the privilege to call this method.
+               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method.
+               * @remarks      The specific error code can be accessed using the GetLastResult() method.
+               */
+               int GetId(void) const;
+
        private:
                _MmsMessageImpl* __pImpl;
 

diff --git a/inc/FMsgSmsManager.h b/inc/FMsgSmsManager.h
index 877a5fd..7531b29 100755 (executable)
--- a/inc/FMsgSmsManager.h
+++ b/inc/FMsgSmsManager.h
@@ -143,7 +143,7 @@ namespace Tizen { namespace Messaging
                * @param[in]    listener                                The listener to receive a sent result asynchronously
                * @exception    E_SUCCESS                               The method is successful.
                * @exception    E_OUT_OF_MEMORY                 The memory is insufficient.
-               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
+               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
                *                                                                               For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
                * @remarks      Before calling this method, check whether the feature is supported by 
                *                               Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
@@ -208,7 +208,7 @@ namespace Tizen { namespace Messaging
                * @exception    E_OUT_OF_MEMORY                 The memory is insufficient.
                * @exception    E_OBJ_ALREADY_EXIST             The listener already exists.
                * @exception    E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
-               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method. @b Since: @b 2.1
+               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method.
                * @see          RemoveSmsMessageEventListener()
                */
                result AddSmsMessageEventListener(ISmsMessageEventListener& eventListener);
@@ -228,7 +228,7 @@ namespace Tizen { namespace Messaging
                * @exception    E_OBJ_NOT_FOUND                 The listener is not found.
                * @exception    E_SYSTEM                                A system error has occurred.
                * @exception    E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
-               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method. @b Since: @b 2.1
+               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method.
                * @see                  AddSmsMessageEventListener()
                */
                result RemoveSmsMessageEventListener(ISmsMessageEventListener& eventListener);
@@ -256,7 +256,7 @@ namespace Tizen { namespace Messaging
                * @exception    E_INVALID_ARG                   The number of recipients is @c 0.
                * @exception    E_MAX_EXCEEDED                  The number of recipients has crossed the maximum limit (Maximum 10).
                * @exception    E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
-               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method. @b Since: @b 2.1
+               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method.
                * @remarks              The CC and BCC recipients in the @c recipientList are ignored while sending an SMS message.
                * @see                  ISmsListener::OnSmsMessageSent()
                */
@@ -276,8 +276,8 @@ namespace Tizen { namespace Messaging
                * @exception    E_INVALID_ARG                   The specified @c type is invalid.
                * @exception    E_SYSTEM                                A system error has occurred.
                * @exception    E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
-               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method. @b Since: @b 2.1
-               * @remarks              
+               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method.
+               * @remarks
                *                       - In case of an error, this method returns a negative value. For example, @c -1.
                *                       - The specific error code can be accessed using the GetLastResult() method.
                */
@@ -296,8 +296,8 @@ namespace Tizen { namespace Messaging
                *                                                               In case of @c null or an empty string, this method searches all the SMS messages in the Inbox regardless of the keyword.
                * @param[in]    pSenderAddress          A telephone number as a sender address (exact match) @n
                *                                                               In case of @c null or an empty string, this method searches all the SMS messages in the Inbox regardless of the sender address.
-               * @param[in]    startIndex                              The starting index (base 0)
-               * @param[in]    count                           The count of SMS messages to search
+               * @param[in]    offset                          The offset of the searched results (base 0)
+               * @param[in]    maxCount                        The maximum count of SMS messages to search
                * @param[out]   totalResultCount                The total count of the searched result
                * @exception    E_SUCCESS                       The method is successful.
                * @exception    E_INVALID_ARG           Either of the following conditions has occurred:
@@ -305,14 +305,13 @@ namespace Tizen { namespace Messaging
                *                                                               - The specified @c pKeyword string length is greater than @c 30.
                *                                                               - The specified @c pSenderAddress string length is less than @c 3.
                *                                                               - The specified @c pSenderAddress string length is greater than @c 41.
-               *                                                               - The specified @c startIndex value is less than @c 0.
-               *                                                               - The specified @c count value is less than @c 0.
-               *                                                               - The specified @c count value is greater than @c 20.
+               *                                                               - The specified @c offset value is less than @c 0.
+               *                                                               - The specified @c maxCount value is less than @c 0.
                * @exception    E_OUT_OF_MEMORY                 The memory is insufficient.
                * @exception    E_SYSTEM                                A system error has occurred.
                * @exception    E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
-               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method. @b Since: @b 2.1
-               * @remarks              
+               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method.
+               * @remarks
                *                       - The specific error code can be accessed using the GetLastResult() method.
                *                       - The search with the specified keywords uses only the first 50 characters of the body text.
                *                       - The SMS messages in the searched result contain only @c 160 bytes for the body text.
@@ -320,7 +319,7 @@ namespace Tizen { namespace Messaging
                *                       - To get the full body text, use GetFullText() with its message ID.
                * @see          GetFullText()
                */
-               Tizen::Base::Collection::IList* SearchInboxN(const Tizen::Base::String* pKeyword, const Tizen::Base::String* pSenderAddress, int startIndex, int count, int& totalResultCount) const;
+               Tizen::Base::Collection::IList* SearchInboxN(const Tizen::Base::String* pKeyword, const Tizen::Base::String* pSenderAddress, int offset, int maxCount, int& totalResultCount) const;
 
           /**
                * Searches the SMS messages by keyword in the specified message box.
@@ -334,22 +333,21 @@ namespace Tizen { namespace Messaging
                * @param[in]    type                                    The type of message box
                * @param[in]    pKeyword                                A part of the body text as a keyword (partial match) @n
                *                                                               In case of @c null or an empty string, this method searches all the SMS messages in the specified message box.
-               * @param[in]    startIndex                              The start index (base 0)
-               * @param[in]    count                           The count of SMS messages to search
+               * @param[in]    offset                          The offset of the searched results
+               * @param[in]    maxCount                        The maximum count of SMS messages to search
                * @param[out]   totalResultCount                The total count of the searched result
                * @exception    E_SUCCESS                       The method is successful.
                * @exception    E_INVALID_ARG           Either of the following conditions has occurred:
                *                                                               - The specified @c type is invalid.
                *                                                               - The specified @c pKeyword string length is less than @c 2.
                *                                                               - The specified @c pKeyword string length is greater than @c 30.
-               *                                                               - The specified @c startIndex value is less than @c 0.
-               *                                                               - The specified @c count value is less than @c 0.
-               *                                                               - The specified @c count value is greater than @c 20.
+               *                                                               - The specified @c offset value is less than @c 0.
+               *                                                               - The specified @c maxCount value is less than @c 0.
                * @exception    E_OUT_OF_MEMORY                 The memory is insufficient.
                * @exception    E_SYSTEM                                A system error has occurred.
                * @exception    E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
-               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method. @b Since: @b 2.1
-               * @remarks              
+               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method.
+               * @remarks
                *                               - The specific error code can be accessed using the GetLastResult() method.
                *                               - The search with the specified keywords uses only the first 50 characters of the body text.
                *                               - The SMS messages in the searched result contain only @c 160 bytes for the body text.
@@ -357,7 +355,7 @@ namespace Tizen { namespace Messaging
                *                               - To get the full body text, use the GetFullText() method with the message ID.
                * @see                  GetFullText()
                */
-               Tizen::Base::Collection::IList* SearchMessageBoxN(SmsMessageBoxType type, const Tizen::Base::String* pKeyword, int startIndex, int count, int& totalResultCount) const;
+               Tizen::Base::Collection::IList* SearchMessageBoxN(SmsMessageBoxType type, const Tizen::Base::String* pKeyword, int offset, int maxCount, int& totalResultCount) const;
 
           /**
                * Gets the full text of the SMS message in the message box using the message ID.
@@ -377,7 +375,7 @@ namespace Tizen { namespace Messaging
                * @exception    E_OBJ_NOT_FOUND                 The SMS message with the specified @c messageId is not found.
                * @exception    E_SYSTEM                                A system error has occurred.
                * @exception    E_PRIVILEGE_DENIED      The application does not have the privilege to call this method.
-               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method. @b Since: @b 2.1
+               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method.
                * @remarks              The specific error code can be accessed using the GetLastResult() method.
                * @see                  SmsMessage::HasMoreText()
                */
@@ -396,7 +394,7 @@ namespace Tizen { namespace Messaging
                * @exception    E_SUCCESS                               The method is successful.
                * @exception    E_SYSTEM                                A system error has occurred.
                * @exception    E_PRIVILEGE_DENIED      The application does not have the privilege to call this method.
-               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
+               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
                *                                                                               For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
                * @remarks      Before calling this method, check whether the feature is supported by
                *                               Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
@@ -416,7 +414,7 @@ namespace Tizen { namespace Messaging
                * @exception    E_SUCCESS                               The method is successful.
                * @exception    E_SYSTEM                                A system error has occurred.
                * @exception    E_PRIVILEGE_DENIED      The application does not have the privilege to call this method.
-               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
+               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
                *                                                                               For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
                * @remarks      Before calling this method, check whether the feature is supported by
                *                               Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
@@ -437,7 +435,7 @@ namespace Tizen { namespace Messaging
                * @exception    E_SUCCESS                               The method is successful.
                * @exception    E_SYSTEM                                A system error has occurred.
                * @exception    E_PRIVILEGE_DENIED      The application does not have the privilege to call this method.
-               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
+               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
                *                                                                               For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
                * @remarks      Before calling this method, check whether the feature is supported by
                *                               Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
@@ -471,7 +469,7 @@ namespace Tizen { namespace Messaging
                * @exception    E_SUCCESS               The method is successful.
                * @exception    E_SYSTEM                A system error has occurred.
                * @exception    E_PRIVILEGE_DENIED      The application does not have the privilege to call this method.
-               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
+               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
                *                                                                               For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
                * @remarks      Before calling this method, check whether the feature is supported by
                *                               Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
@@ -505,7 +503,7 @@ namespace Tizen { namespace Messaging
                * @exception    E_ILLEGAL_ACCESS                The application does not have the permission to add the CBS channel.
                * @exception    E_SYSTEM                                A system error has occurred.
                * @exception    E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
-               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
+               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
                *                                                                               For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
                * @remarks      Before calling this method, check whether the feature is supported by
                *                               Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
@@ -534,7 +532,7 @@ namespace Tizen { namespace Messaging
                * @exception    E_ILLEGAL_ACCESS                The application does not have the permission to remove the CBS channel.
                * @exception    E_SYSTEM                                A system error has occurred.
                * @exception    E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
-               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
+               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
                *                                                                               For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
                * @remarks      Before calling this method, check whether the feature is supported by
                *                               Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
@@ -561,7 +559,7 @@ namespace Tizen { namespace Messaging
                *                                                                       - The range (@c to - @c from) exceeds the limit (0xFFFF).
                * @exception    E_SYSTEM                                A system error has occurred.
                * @exception    E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
-               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
+               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
                *                                                                               For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
                * @remarks
                *                       - Before calling this method, check whether the feature is supported by
@@ -585,7 +583,7 @@ namespace Tizen { namespace Messaging
                * @exception    E_SUCCESS                               The method is successful.
                * @exception    E_SYSTEM                                A system error has occurred.
                * @exception    E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
-               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
+               * @exception    E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
                *                                                                               For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
                * @remarks
                *                       - Before calling this method, check whether the feature is supported by
@@ -597,6 +595,36 @@ namespace Tizen { namespace Messaging
                */
                Tizen::Base::Collection::IList* GetCbsChannelListN(void);
 
+          /**
+               * Searches all the SMS messages by keyword in the specified message box.
+               *
+               * @since                3.0
+               * @privlevel    public
+               * @privilege    %http://tizen.org/privilege/messaging.read @n
+               *
+               * @return               A pointer to the IEnumerator object, which contains list of searched SmsMessage instances
+               * @param[in]    type                                    The type of message box
+               * @param[in]    pKeyword                                A part of the body text as a keyword (partial match) @n
+               *                                                               In case of @c null or an empty string, this method searches all the SMS messages in the specified message box.
+               * @exception    E_SUCCESS                       The method is successful.
+               * @exception    E_INVALID_ARG           Either of the following conditions has occurred:
+               *                                                               - The specified @c type is invalid.
+               *                                                               - The specified @c pKeyword string length is less than @c 2.
+               *                                                               - The specified @c pKeyword string length is greater than @c 30.
+               * @exception    E_OUT_OF_MEMORY                 The memory is insufficient.
+               * @exception    E_SYSTEM                                A system error has occurred.
+               * @exception    E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
+               * @exception    E_USER_NOT_CONSENTED    The user has blocked the application from calling this method.
+               * @remarks
+               *                               - The specific error code can be accessed using the GetLastResult() method.
+               *                               - The search with the specified keywords uses only the first 50 characters of the body text.
+               *                               - The SMS messages in the searched result contain only @c 160 bytes for the body text.
+               *                               - To check whether there is additional text, use the SmsMessage::HasMoreText() method.
+               *                               - To get the full body text, use the GetFullText() method with the message ID.
+               * @see                  GetFullText()
+               */
+               Tizen::Base::Collection::IEnumerator* SearchMessageBoxN(SmsMessageBoxType type, const Tizen::Base::String* pKeyword) const;
+
        private:
                _SmsManagerImpl* __pImpl;
 

diff --git a/inc/FMsgTypes.h b/inc/FMsgTypes.h
index 972f44f..9132a66 100755 (executable)
--- a/inc/FMsgTypes.h
+++ b/inc/FMsgTypes.h
@@ -113,7 +113,23 @@ namespace Tizen { namespace Messaging
                PUSH_ACTION_SILENT = 0,         /**< Store the message without alerting the user */
                PUSH_ACTION_DISCARD,            /**< Discard the message */
                PUSH_ACTION_ALERT,                      /**< Store the message and alert the user */
-               PUSH_ACTION_LAUNCH          /**< Launch the application @b Since: @b 2.1 */
+               PUSH_ACTION_LAUNCH          /**< Launch the application */
+       };
+
+       /**
+       * @enum MmsMessageBoxType
+       *
+       * Defines the message box type for Multimedia Message Service(MMS) messages.
+       *
+       * @since                3.0
+       */
+       enum MmsMessageBoxType
+       {
+               MMS_MESSAGE_BOX_TYPE_NONE = -1,         /**< None */
+               MMS_MESSAGE_BOX_TYPE_INBOX = 0,         /**< The Inbox type */
+               MMS_MESSAGE_BOX_TYPE_SENTBOX = 1,       /**< The Sentbox type */
+               MMS_MESSAGE_BOX_TYPE_OUTBOX = 2,        /**< The Outbox type */
+               MMS_MESSAGE_BOX_TYPE_ALL = 10           /**< All message boxes type */
        };
 
 } } // Tizen::Messaging