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

NAME

8       mail::ACCOUNT::copyMessagesTo - Copy messages to another folder
9

SYNOPSIS

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

USAGE

23       msgList specifies a list of messages. Messages are numbered starting
24       with message #0 and up to one less than
25       mail::ACCOUNT::getFolderIndexSize(3x) (when
26       mail::account::getFolderIndexSize returns 6, the messages are numbered
27       0 through 5). Only the messages that appear in msgList are processed by
28       this request. When a message is removed from the folder, by
29       mail::ACCOUNT::updateFolderIndexInfo(3x), the following messages are
30       renumbered accordingly.
31
32           Note
33           Most mail servers allow multiple applications to open the same
34           folder. Therefore, changes to the folder's contents can occur at
35           any time. Before making this request, the application should use
36           mail::ACCOUNT::checkNewMail(3x) to verify that no unexpected
37           changes have been made to the folder's contents.
38
39       mail::ACCOUNT::copyMessagesTo copies messages in the currently-open
40       folder to another folder.  copyTo is a pointer to a mail::folder
41       object, representing the folder where messages are copied to. If
42       account is an IMAP account and copyTo is another folder in the same
43       account, then the messages are quickly copied by the IMAP server.
44       Otherwise each message is individually downloaded and copied to the
45       copyTo folder.
46

RETURN CODES

48       This method returns true if it succeeds, or false if it fails. If the
49       method fails, use mail::ACCOUNT::getErrmsg() to read a brief
50       description of the error.
51

SEE ALSO

53       mail::ACCOUNT::moveMessagesTo(3x), mail::ACCOUNT::searchMessages(3x).
54

AUTHOR

56       Sam Varshavchik
57
58
59
60Cone©                             08/25/2016          MAIL::ACCOUNT::COPYM(3x)
Impressum