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

NAME

6       mail::ACCOUNT::copyMessagesTo - Copy 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->copyMessagesTo(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::copyMessagesTo copies messages in the currently-open
38       folder to another folder.  copyTo is a pointer to a mail::folder
39       object, representing the folder where messages are copied to. If
40       account is an IMAP account and copyTo is another folder in the same
41       account, then the messages are quickly copied by the IMAP server.
42       Otherwise each message is individually downloaded and copied to the
43       copyTo folder.
44

RETURN CODES

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

SEE ALSO

51       mail::ACCOUNT::moveMessagesTo(3x), mail::ACCOUNT::searchMessages(3x).
52
53
54
55[FIXME: source]                   05/08/2010          MAIL::ACCOUNT::COPYM(3x)
Impressum