summaryrefslogtreecommitdiff
path: root/cmc/xcmc.h
blob: 3fac641d2370de9ec8d78940f1ecd55dee669a36 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
/* GNU Mailutils -- a suite of utilities for electronic mail
   Copyright (C) 1999-2019 Free Software Foundation, Inc.

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
   License as published by the Free Software Foundation; either
   version 3 of the License, or (at your option) any later version.

   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Lesser General Public License for more details.

   You should have received a copy of the GNU Lesser General Public
   License along with this library.  If not, see
   <http://www.gnu.org/licenses/>. */

#ifndef _XCMC_H
#define _XCMC_H

#ifdef __cplusplus
extern "C" {
#endif

/*BEGIN CMC INTERFACE */

/*BASIC DATA TYPES */
#ifndef DIFFERENT_PLATFORM
typedef char CMC_sint8;
typedef int CMC_sint16;
typedef long int CMC_sint32;
typedef unsigned int CMC_uint16;
typedef unsigned long int CMC_uint32;
typedef void * CMC_buffer;
typedef char * CMC_string;
typedef CMC_uint32 CMC_session_id;
typedef CMC_uint32 CMC_ui_id;
#endif

typedef CMC_uint16 CMC_boolean;
typedef CMC_sint32 CMC_enum;
typedef CMC_uint32 CMC_return_code;
typedef CMC_uint32 CMC_flags;
typedef CMC_string CMC_object_identifier;

#define CMC_FALSE ((CMC_boolean)0)
#define CMC_TRUE ((CMC_boolean)1)

/*DATA STRUCTURES*/

/*EXTENSION*/
typedef struct
{
  CMC_uint32 item_code;
  CMC_uint32 item_data;
  CMC_buffer item_reference;
  CMC_flags extension_flags;
} CMC_extension;

/*ATTACHMENT*/
typedef struct
{
  CMC_string attach_title;
  CMC_object_identifier attach_type;
  CMC_string attach_filename;
  CMC_flags attach_flags;
  CMC_extension *attach_extensions;
} CMC_attachment;

/* ATTACHMENT FLAGS */
#define CMC_ATT_APP_OWNS_FILE ((CMC_flags) 1)
#define CMC_ATT_LAST_ELEMENT ((CMC_flags) 0x80000000)

/* ATTACHMENT OBJECT IDS */
#define CMC_ATT_OID_BINARY "1 2 840 113658 1 1"
#define CMC_ATT_OID_TEXT "1 2 840 113658 1 1 0"

/*COUNTED STRING*/
typedef struct
{
  CMC_uint32 length;
  char string[1];
} CMC_counted_string;

/* EXTENSION FLAGS */
#define CMC_EXT_REQUIRED ((CMC_flags) 0x00010000)
#define CMC_EXT_OUTPUT ((CMC_flags) 0x00020000)
#define CMC_EXT_LAST_ELEMENT ((CMC_flags) 0x80000000)
#define CMC_EXT_RSV_FLAG_MASK ((CMC_flags) 0xFFFF0000)
#define CMC_EXT_ITEM_FLAG_MASK ((CMC_flags) 0x0000FFFF)

/*MESSAGE REFERENCE*/
typedef CMC_counted_string CMC_message_reference;

/*TIME*/
typedef struct
{
  CMC_sint8 second;
  CMC_sint8 minute;
  CMC_sint8 hour;
  CMC_sint8 day;
  CMC_sint8 month;
  CMC_sint8 year;
  CMC_sint8 isdst;
  CMC_sint16 tmzone;
} CMC_time;

/*RECIPIENT*/
typedef struct
{
  CMC_string name;
  CMC_enum name_type;
  CMC_string address;
  CMC_enum role;
  CMC_flags recip_flags;
  CMC_extension *recip_extensions;
} CMC_recipient;

/*MESSAGE*/
typedef struct
{
  CMC_message_reference *message_reference;
  CMC_string message_type;
  CMC_string subject;
  CMC_time time_sent;
  CMC_string text_note;
  CMC_recipient *recipients;
  CMC_attachment *attachments;
  CMC_flags message_flags;
  CMC_extension *message_extensions;
} CMC_message;

/* MESSAGE FLAGS */
#define CMC_MSG_READ ((CMC_flags) 1)
#define CMC_MSG_TEXT_NOTE_AS_FILE ((CMC_flags) 2)
#define CMC_MSG_UNSENT ((CMC_flags) 4)
#define CMC_MSG_LAST_ELEMENT ((CMC_flags) 0x80000000)

/*MESSAGE SUMMARY*/
typedef struct
{
  CMC_message_reference *message_reference;
  CMC_string message_type;
  CMC_string subject;
  CMC_time time_sent;
  CMC_uint32 byte_length;
  CMC_recipient *originator;
  CMC_flags summary_flags;
  CMC_extension *message_summary_extensions;
} CMC_message_summary;

/* MESSAGE SUMMARY FLAGS */
#define CMC_SUM_READ ((CMC_flags) 1)
#define CMC_SUM_UNSENT ((CMC_flags) 2)
#define CMC_SUM_LAST_ELEMENT ((CMC_flags) 0x80000000)

/* NAME TYPES */
#define CMC_TYPE_UNKNOWN ((CMC_enum) 0)
#define CMC_TYPE_INDIVIDUAL ((CMC_enum) 1)
#define CMC_TYPE_GROUP ((CMC_enum) 2)

/* ROLES */
#define CMC_ROLE_TO ((CMC_enum) 0)
#define CMC_ROLE_CC ((CMC_enum) 1)
#define CMC_ROLE_BCC ((CMC_enum) 2)
#define CMC_ROLE_ORIGINATOR ((CMC_enum) 3)
#define CMC_ROLE_AUTHORIZING_USER ((CMC_enum) 4)

/* RECIPIENT FLAGS */
#define CMC_RECIP_IGNORE ((CMC_flags) 1)
#define CMC_RECIP_LIST_TRUNCATED ((CMC_flags) 2)
#define CMC_RECIP_LAST_ELEMENT ((CMC_flags) 0x80000000)

/* TIME FLAGS */
#define CMC_NO_TIMEZONE ((CMC_flags) 0x8000)

/*CMC FUNCTIONS *//*CROSS FUNCTION FLAGS */
#define CMC_ERROR_UI_ALLOWED ((CMC_flags) 0x01000000)
#define CMC_LOGON_UI_ALLOWED ((CMC_flags) 0x02000000)
#define CMC_COUNTED_STRING_TYPE ((CMC_flags) 0x04000000)

/*SEND*/
CMC_return_code cmc_send (CMC_session_id session,
			  CMC_message * message,
			  CMC_flags send_flags, CMC_ui_id ui_id,
			  CMC_extension * send_extensions);

#define CMC_SEND_UI_REQUESTED ((CMC_flags) 1)

/*SEND DOCUMENTS*/
CMC_return_code cmc_send_documents (CMC_string recipient_addresses,
				    CMC_string subject,
				    CMC_string text_note,
				    CMC_flags send_doc_flags,
				    CMC_string file_paths,
				    CMC_string attach_titles,
				    CMC_string delimiter,
				    CMC_ui_id ui_id);

#define CMC_FIRST_ATTACH_AS_TEXT_NOTE ((CMC_flags) 2)

/*ACT ON*/
CMC_return_code cmc_act_on (CMC_session_id session,
			    CMC_message_reference * message_reference,
			    CMC_enum operation,
			    CMC_flags act_on_flags,
			    CMC_ui_id ui_id,
			    CMC_extension * act_on_extensions);

#define CMC_ACT_ON_EXTENDED ((CMC_enum) 0)
#define CMC_ACT_ON_DELETE ((CMC_enum) 1)

/*LIST*/
CMC_return_code cmc_list (CMC_session_id session,
			  CMC_string message_type,
			  CMC_flags list_flags,
			  CMC_message_reference * seed,
			  CMC_uint32 * count, CMC_ui_id ui_id,
			  CMC_message_summary ** result,
			  CMC_extension * list_extensions);

#define CMC_LIST_UNREAD_ONLY ((CMC_flags) 1)
#define CMC_LIST_MSG_REFS_ONLY ((CMC_flags) 2)
#define CMC_LIST_COUNT_ONLY ((CMC_flags) 4)

#define CMC_LENGTH_UNKNOWN 0xFFFFFFFF

/*READ*/
CMC_return_code cmc_read (CMC_session_id session,
			  CMC_message_reference * message_reference,
			  CMC_flags read_flags,
			  CMC_message ** message, CMC_ui_id ui_id,
			  CMC_extension * read_extensions);

#define CMC_DO_NOT_MARK_AS_READ ((CMC_flags) 1)
#define CMC_MSG_AND_ATT_HDRS_ONLY ((CMC_flags) 2)
#define CMC_READ_FIRST_UNREAD_MESSAGE ((CMC_flags) 4)

/*LOOK UP*/
CMC_return_code cmc_look_up (CMC_session_id session,
			     CMC_recipient * recipient_in,
			     CMC_flags look_up_flags,
			     CMC_ui_id ui_id, CMC_uint32 * count,
			     CMC_recipient ** recipient_out,
			     CMC_extension * look_up_extensions);

#define CMC_LOOKUP_RESOLVE_PREFIX_SEARCH ((CMC_flags) 1)
#define CMC_LOOKUP_RESOLVE_IDENTITY ((CMC_flags) 2)
#define CMC_LOOKUP_RESOLVE_UI ((CMC_flags) 4)
#define CMC_LOOKUP_DETAILS_UI ((CMC_flags) 8)
#define CMC_LOOKUP_ADDRESSING_UI ((CMC_flags) 16)

/*FREE*/
CMC_return_code cmc_free (CMC_buffer memory);

/* LOGOFF */
CMC_return_code cmc_logoff (CMC_session_id session,
			    CMC_ui_id ui_id,
			    CMC_flags logoff_flags,
			    CMC_extension * logoff_extensions);

#define CMC_LOGOFF_UI_ALLOWED ((CMC_flags) 1)

/* LOGON */
CMC_return_code cmc_logon (CMC_string service, CMC_string user,
			   CMC_string password,
			   CMC_object_identifier character_set,
			   CMC_ui_id ui_id,
			   CMC_uint16 caller_cmc_version,
			   CMC_flags logon_flags,
			   CMC_session_id * session,
			   CMC_extension * logon_extensions);

#define CMC_VERSION ((CMC_uint16) 100)

/* QUERY CONFIGURATION */
CMC_return_code cmc_query_configuration (CMC_session_id session,
					 CMC_enum item, CMC_buffer reference,
					 CMC_extension * config_extensions);

#define CMC_CONFIG_CHARACTER_SET ((CMC_enum) 1)
#define CMC_CONFIG_LINE_TERM ((CMC_enum) 2)
#define CMC_CONFIG_DEFAULT_SERVICE ((CMC_enum) 3)
#define CMC_CONFIG_DEFAULT_USER ((CMC_enum) 4)
#define CMC_CONFIG_REQ_PASSWORD ((CMC_enum) 5)
#define CMC_CONFIG_REQ_SERVICE ((CMC_enum) 6)
#define CMC_CONFIG_REQ_USER ((CMC_enum) 7)
#define CMC_CONFIG_UI_AVAIL ((CMC_enum) 8)
#define CMC_CONFIG_SUP_NOMKMSGREAD ((CMC_enum) 9)
#define CMC_CONFIG_SUP_COUNTED_STR ((CMC_enum) 10)
#define CMC_CONFIG_VER_IMPLEM ((CMC_enum) 11)
#define CMC_CONFIG_VER_SPEC ((CMC_enum) 12)

/* CONFIG LINE TERM ENUM */
#define CMC_LINE_TERM_CRLF ((CMC_enum) 0)
#define CMC_LINE_TERM_CR ((CMC_enum) 1)
#define CMC_LINE_TERM_LF ((CMC_enum) 2)

/* CONFIG REQUIRED LOGON PARAMETER ENUM */
#define CMC_REQUIRED_NO ((CMC_enum) 0)
#define CMC_REQUIRED_YES ((CMC_enum) 1)
#define CMC_REQUIRED_OPT ((CMC_enum) 2)

/* DEFINED OBJECT ID'S FOR CHARACTER SETS */
#define CMC_CHARSET_437 "1 2 840 113658 1 2 437"
#define CMC_CHARSET_850 "1 2 840 113658 1 2 850"
#define CMC_CHARSET_1252 "1 2 840 113658 1 2 1252"
#define CMC_CHARSET_ISTRING "1 2 840 113658 1 3 0"
#define CMC_CHARSET_UNICODE "1 2 840 113658 1 3 1"
#define CMC_CHARSET_T61 "0 0 20 61"
#define CMC_CHARSET_IA5 "0 0 20 50"
#define CMC_CHARSET_ISO_10646 "2 1 0 0 0"
#define CMC_CHARSET_ISO_646 "1 0 646"

/* RETURN CODES FLAGS */
#define CMC_ERROR_UI_DISPLAYED      ((CMC_return_code) 0x00008000)
#define CMC_ERROR_RSV_MASK          ((CMC_return_code) 0x0000FFFF)
#define CMC_ERROR_IMPL_MASK         ((CMC_return_code) 0xFFFF0000)

/* RETURN CODES */
#define CMC_SUCCESS ((CMC_return_code) 0)

#define CMC_E_AMBIGUOUS_RECIPIENT ((CMC_return_code) 1)
#define CMC_E_ATTACHMENT_NOT_FOUND ((CMC_return_code) 2)
#define CMC_E_ATTACHMENT_OPEN_FAILURE ((CMC_return_code) 3)
#define CMC_E_ATTACHMENT_READ_FAILURE ((CMC_return_code) 4)
#define CMC_E_ATTACHMENT_WRITE_FAILURE ((CMC_return_code) 5)
#define CMC_E_COUNTED_STRING_UNSUPPORTED ((CMC_return_code) 6)
#define CMC_E_DISK_FULL ((CMC_return_code) 7)
#define CMC_E_FAILURE ((CMC_return_code) 8)
#define CMC_E_INSUFFICIENT_MEMORY ((CMC_return_code) 9)
#define CMC_E_INVALID_CONFIGURATION ((CMC_return_code) 10)
#define CMC_E_INVALID_ENUM ((CMC_return_code) 11)
#define CMC_E_INVALID_FLAG ((CMC_return_code) 12)
#define CMC_E_INVALID_MEMORY ((CMC_return_code) 13)
#define CMC_E_INVALID_MESSAGE_PARAMETER ((CMC_return_code) 14)
#define CMC_E_INVALID_MESSAGE_REFERENCE ((CMC_return_code) 15)
#define CMC_E_INVALID_PARAMETER ((CMC_return_code) 16)
#define CMC_E_INVALID_SESSION_ID ((CMC_return_code) 17)
#define CMC_E_INVALID_UI_ID ((CMC_return_code) 18)
#define CMC_E_LOGON_FAILURE ((CMC_return_code) 19)
#define CMC_E_MESSAGE_IN_USE ((CMC_return_code) 20)
#define CMC_E_NOT_SUPPORTED ((CMC_return_code) 21)
#define CMC_E_PASSWORD_REQUIRED ((CMC_return_code) 22)
#define CMC_E_RECIPIENT_NOT_FOUND ((CMC_return_code) 23)

#define CMC_E_SERVICE_UNAVAILABLE ((CMC_return_code) 24)
#define CMC_E_TEXT_TOO_LARGE ((CMC_return_code) 25)
#define CMC_E_TOO_MANY_FILES ((CMC_return_code) 26)
#define CMC_E_TOO_MANY_RECIPIENTS ((CMC_return_code) 27)
#define CMC_E_UNABLE_TO_NOT_MARK_READ ((CMC_return_code) 28)
#define CMC_E_UNRECOGNIZED_MESSAGE_TYPE ((CMC_return_code) 29)
#define CMC_E_UNSUPPORTED_ACTION ((CMC_return_code) 30)
#define CMC_E_UNSUPPORTED_CHARACTER_SET ((CMC_return_code) 31)
#define CMC_E_UNSUPPORTED_DATA_EXT ((CMC_return_code) 32)
#define CMC_E_UNSUPPORTED_FLAG ((CMC_return_code) 33)
#define CMC_E_UNSUPPORTED_FUNCTION_EXT ((CMC_return_code) 34)
#define CMC_E_UNSUPPORTED_VERSION ((CMC_return_code) 35)
#define CMC_E_USER_CANCEL ((CMC_return_code) 36)
#define CMC_E_USER_NOT_LOGGED_ON ((CMC_return_code) 37)

#ifdef __cplusplus
}       /* extern "C" */
#endif

#endif  /* _XCMC_H */

Return to:

Send suggestions and report system problems to the System administrator.