1MAIL::FOLDER::CLONE(3x)mail::folder Native API referenceMAIL::FOLDER::CLONE(3x)
2
3
4
6 mail::folder::clone - Clone a mail::folder object
7
9 mail::folder *folder;
10
11 mail::folder *folderCopy;
12
13
14
15 folderCopy=folder->clone(void);
16
18 This function creates a new mail::folder object that refers to the same
19 mail folder, in every possible way. This is usually used by some call‐
20 back methods that receive pointers to mail::folders, and wish to pre‐
21 serve them for the main application (mail::folders received by callback
22 methods are usually destroyed as soon as the callback method termi‐
23 nates).
24
26 Note: mail::folders are linked to their corresponding
27 mail::accounts. A mail::folder created by one mail::account may
28 not be used with a different mail::folder. All mail::folders
29 created by a mail::account are invalidated when this
30 mail::account object is destroyed. Note that the mail::folder
31 objects are not automatically destroyed; the application is
32 still responsible for destroying any remaining mail::folders,
33 after their a mail::account is destroyed.
34
36 mail::folder::createSubFolder(3x), mail::folder::readSubFolders(3x).
37
38
39
40 10 April 2006 MAIL::FOLDER::CLONE(3x)