1mail::account::checkNewmMaaiill:(:3axc)count Native API rmeafielr:e:naccecount::checkNewMail(3x)
2
3
4
6 mail::account::checkNewMail - Check for new mail
7
9 #include <libmail/mail.H>
10
11
12 class myCallback : public mail::callback {
13 public:
14 void success(std::string msg);
15 void fail(std::string msg);
16 };
17
18 mail::account *account;
19
20
21
22 account->checkNewMail (myCallback &callback);
23
25 This request checks for new messages in the currently open folder.
26 With some accounts this request also checks for any messages that were
27 removed from the folder by another process or application.
28
30 The application must wait until callback's success or fail method is
31 invoked. The success method is invoked when this request is succes‐
32 fully processed. The fail method is invoked if this request cannot be
33 processed. The application must not destroy callback until either the
34 success or fail method is invoked.
35
36 Note: callback's fail method may be invoked even after other
37 callback methods were invoked. This indicates that the request
38 was partially completed before the error was encountered.
39
40 This request may result in additional callback methods invoked before
41 the success method is invoked. The currently opened folder's call‐
42 back::folder's object's newMessages method will be invoked if the cur‐
43 rent folder has any new messages. The messagesRemoved and mes‐
44 sageChanged methods may also be invoked.
45
46
47
48 10 April 2006 mail::account::checkNewMail(3x)