1MAIL::ACCOUNT::MOVEM(3x)Cone: COnsole Newsreader And EMAIL::ACCOUNT::MOVEM(3x)
2
3
4

NAME

6       mail::ACCOUNT::moveMessagesTo - Move messages to another folder
7

SYNOPSIS

9       #include <libmail/sync.H>
10
11
12       mail::ACCOUNT *mail;
13       mail::folder *folder;
14
15       bool ok=mail->moveMessagesTo(const std::vector<size_t> &msgList,
16                                    mail::folder *copyTo);
17
18                                    std::string errmsg=mail->getErrmsg();
19

USAGE

21       msgList specifies a list of messages. Messages are numbered starting
22       with message #0 and up to one less than
23       mail::ACCOUNT::getFolderIndexSize(3x) (when
24       mail::account::getFolderIndexSize returns 6, the messages are numbered
25       0 through 5). Only the messages that appear in msgList are processed by
26       this request. When a message is removed from the folder, by
27       mail::ACCOUNT::updateFolderIndexInfo(3x), the following messages are
28       renumbered accordingly.
29
30           Note
31           Most mail servers allow multiple applications to open the same
32           folder. Therefore, changes to the folder´s contents can occur at
33           any time. Before making this request, the application should use
34           mail::ACCOUNT::checkNewMail(3x) to verify that no unexpected
35           changes have been made to the folder´s contents.
36
37       mail::ACCOUNT::moveMessagesTo moves messages in the currently-open
38       folder to another folder. It´s similar to
39       mail::ACCOUNT::copyMessagesTo(3x), except that the messages are moved,
40       instead of copied.
41
42       copyTo is a pointer to a mail::folder object, representing the folder
43       where messages are moved to.  copyTo may be a folder in another mail
44       account, in which case this function transparently copies the indicated
45       messages using mail::ACCOUNT::copyMessagesTo(3x), then the original
46       messages are removed using mail::ACCOUNT::removeMessages(3x). Only SMAP
47       and maildir-based mail accounts can move messages directly between
48       folders; for all other accounts the copy/delete implementation will be
49       used automatically.
50

RETURN CODES

52       This method returns true if it succeeds, or false if it fails. If the
53       method fails, use mail::ACCOUNT::getErrmsg() to read a brief
54       description of the error.
55

SEE ALSO

57       mail::ACCOUNT::copyMessagesTo(3x), mail::ACCOUNT::removeMessages(3x).
58
59
60
61[FIXME: source]                   05/08/2010          MAIL::ACCOUNT::MOVEM(3x)
Impressum