1        Cone©
2
3MAIL::ACCOUNT::SAVEF(3x)Cone: COnsole Newsreader And EMAIL::ACCOUNT::SAVEF(3x)
4
5
6

NAME

8       mail::account::saveFolderIndexInfo - Update message status
9

SYNOPSIS

11       #include <libmail/mail.H>
12
13
14       class myCallback : public mail::callback {
15       public:
16           void success(std::string msg);
17           void fail(std::string msg);
18       };
19
20       mail::account *account;
21
22       account->saveFolderIndexInfo(size_t messageNum,
23                                    const messageInfo &msgInfo,
24                                    myCallback &callback);
25

USAGE

27       mail::account::saveFolderIndexInfo changes the status of a message.
28       messageNum must be between zero and one less than the return code from
29       mail::account::getFolderIndexSize(3x).  msgInfo contains the new status
30       flags for this message. See mail::account::getFolderIndexInfo(3x) for a
31       description of message status flags.
32
33           Note
34           The uid field in msgInfo is ignored. The message is specified by
35           messageNum, and unique IDs of existing messages cannot be changed.
36

RETURN CODES

38       The application must wait until callback's success or fail method is
39       invoked. The success method is invoked when this request is succesfully
40       processed. The fail method is invoked if this request cannot be
41       processed. The application must not destroy callback until either the
42       success or fail method is invoked.
43
44           Note
45           callback's fail method may be invoked even after other callback
46           methods were invoked. This indicates that the request was partially
47           completed before the error was encountered.
48
49           Note
50           The application is notified about when a message's status changes
51           by by invoking the messageChanged callback method of the currently
52           opened folder's mail::folderCallback object. Depending on the mail
53           server, the messageChanged method may be invoked as part of
54           processing this request, or some time later after this request is
55           completed, and callback's success method was invoked.
56
57           Note
58           Multiple applications may have the same account and folder opened
59           at the same time. It is possible that a message referenced by this
60           request was already deleted by another application. Depending on
61           the underlying server implementation this will result in either a
62           failed request, invoking callback.fail, or the request completing
63           (callback.success invoked) but without invoking any callback
64           function that refer to the message.
65

SEE ALSO

67       mail::account::removeMessages(3x),
68       mail::account::updateFolderIndexFlags(3x),
69       mail::account::updateFolderIndexInfo(3x),
70       mail::account::getFolderIndexInfo(3x).
71

AUTHOR

73       Sam Varshavchik
74
75
76
77Cone©                             08/25/2016          MAIL::ACCOUNT::SAVEF(3x)
Impressum