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

NAME

8       mail::account::updateFolderIndexInfo - Update status of the currently
9       open folder
10

SYNOPSIS

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

USAGE

26       This function requests that the status of the currently open folder be
27       updated. Messages marked as deleted are removed. The application will
28       also be notified about changes to the folder made by any other
29       application that has the same folder opened.
30
31       This request invokes methods in the currently opened folder's
32       mail::callback::folder object, as follows:
33
34       ·   The mail::account::messageChanged method is invoked for all
35           messages which have an updated status flag set.
36
37       ·   mail::account::messagesRemoved is invoked for all messages removed
38           from the folder (those that were marked as deleted by this
39           application and those that were removed from the folder by any
40           other application that has this folder opened).
41
42       ·   mail::account::newMessages is invoked if any messages were added to
43           this folder. The application should use
44           mail::account::getFolderIndexSize(3x), and compare it to the
45           previously-known folder size, in order to determine how many
46           messages were added to the folder (new messages are always added to
47           the end of the message list).
48

RETURN CODES

50       The application must wait until callback's success or fail method is
51       invoked. The success method is invoked when this request is succesfully
52       processed. The fail method is invoked if this request cannot be
53       processed. The application must not destroy callback until either the
54       success or fail method is invoked.
55
56           Note
57           callback's fail method may be invoked even after other callback
58           methods were invoked. This indicates that the request was partially
59           completed before the error was encountered.
60

SEE ALSO

62       mail::account::saveFolderIndexInfo(3x),
63       mail::account::getFolderIndexInfo(3x), mail::account::updateNotify(3x).
64

AUTHOR

66       Sam Varshavchik
67
68
69
70Cone©                             08/25/2016          MAIL::ACCOUNT::UPDAT(3x)
Impressum