mail::folder::clone
Name
mail::folder::clone -- Clone a
mail::folder
object
Synopsis
mail::folder *folder;
mail::folder *folderCopy;
folderCopy=folder->clone
(void);
USAGE
This function creates a new
mail::folder
object that refers to the
same mail folder, in every possible way.
This is usually used by some callback methods that receive pointers to
mail::folder
s, and wish to preserve them for the
main application (mail::folder
s received by
callback methods are usually destroyed as soon as the callback method
terminates).
RETURN CODES AND CALLBACKS
NOTE: | mail::folder s are linked to their corresponding
mail::account s.
A mail::folder created by one
mail::account may not be used with a different
mail::folder .
All
mail::folder s created by
a mail::account are invalidated when
this mail::account object is destroyed.
Note that the
mail::folder objects are not automatically destroyed;
the application is still responsible for destroying any remaining
mail::folder s, after their
a mail::account is destroyed.
|