mail::account::removeMessages.3x man page

       Cone©
     

mail::account::removeMessages — Remove messages from the folder

Synopsis

#include <libmail/mail.H>


class myCallback : public mail::callback {
public:
    void success(std::string msg);
    void fail(std::string msg);
};
mail::account *account;

account->removeMessages(const std::vector<size_t> msgList, myCallback &callback);

Usage

This function removes messages from the currently open folder. msgList is a list of messages to be removed.

This request invokes methods in the currently opened folder's mail::callback::folder object, as follows:

Note

This request should not be used with accounts on IMAP servers that do not implement the UIDPLUS[1] IMAP extension. “UIDPLUS” is required to directly support this functionality. An alternative, much slower, fallback implementation will be used with IMAP servers that do not implement this protocol extension.

Return Codes

The application must wait until callback's success or fail method is invoked. The success method is invoked when this request is succesfully processed. The fail method is invoked if this request cannot be processed. The application must not destroy callback until either the success or fail method is invoked.

Note

callback's fail method may be invoked even after other callback methods were invoked. This indicates that the request was partially completed before the error was encountered.

See Also

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

Author

Sam Varshavchik

Notes

1.

UIDPLUS
http://www.rfc-editor.org/rfc/rfc2359.txt

Info

08/25/2013 Cone© Cone: COnsole Newsreader And E