Tizen 2.0 Release
[platform/core/messaging/email-service.git] / email-api / include / email-api-etc.h
1 /*
2 *  email-service
3 *
4 * Copyright (c) 2012 - 2013 Samsung Electronics Co., Ltd. All rights reserved.
5 *
6 * Contact: Kyuho Jo <kyuho.jo@samsung.com>, Sunghyun Kwon <sh0701.kwon@samsung.com>
7 *
8 * Licensed under the Apache License, Version 2.0 (the "License");
9 * you may not use this file except in compliance with the License.
10 * You may obtain a copy of the License at
11 *
12 * http://www.apache.org/licenses/LICENSE-2.0
13 *
14 * Unless required by applicable law or agreed to in writing, software
15 * distributed under the License is distributed on an "AS IS" BASIS,
16 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
17 * See the License for the specific language governing permissions and
18 * limitations under the License.
19 *
20 */
21
22 /**
23 * @defgroup EMAIL_SERVICE Email Service
24 * @{
25 */
26
27 /**
28 * @ingroup EMAIL_SERVICE
29 * @defgroup EMAIL_API_ETC Email API
30 * @{
31 */
32
33 /**
34  *
35  * This file contains the data structures and interfaces needed for application,
36  * to interact with email-service.
37  * @file        email-api-etc.h
38  * @author      Kyuho Jo <kyuho.jo@samsung.com>
39  * @author      Sunghyun Kwon <sh0701.kwon@samsung.com>
40  * @version     0.1
41  * @brief       This file contains the data structures and interfaces of Accounts provided by
42  *                      email-service .
43  */
44
45 #ifndef __EMAIL_API_ETC_H__
46 #define __EMAIL_API_ETC_H__
47
48 #ifdef __cplusplus
49 extern "C" {
50 #endif /* __cplusplus */
51
52 #include "email-types.h"
53
54 /**
55
56
57  * @fn email_show_user_message(void)
58  * @brief       This function show user message.
59  *
60  * @return This function returns EMAIL_ERROR_NONE on success or error code (refer to EMAIL_ERROR_XXX) on failure.
61  * @exception   none
62  * @see         email_action_t
63  * @remarks N/A
64  */
65 EXPORT_API int email_show_user_message(int id, email_action_t action, int error_code);
66
67 EXPORT_API int email_parse_mime_file(char *eml_file_path, email_mail_data_t **output_mail_data, email_attachment_data_t **output_attachment_data, int *output_attachment_count);
68
69 EXPORT_API int email_write_mime_file(email_mail_data_t *input_mail_data, email_attachment_data_t *input_attachment_data, int input_attachment_count, char **output_file_path);
70
71 EXPORT_API int email_delete_parsed_data(email_mail_data_t *input_mail_data);
72
73 EXPORT_API int email_get_mime_entity(char *mime_path, char **mime_entity);
74 #ifdef __cplusplus
75 }
76 #endif /* __cplusplus */
77
78 #endif /* __EMAIL_API_ETC_H__ */
79
80 /**
81 * @} @}
82 */