Rechercher une page de manuel
mail::ACCOUNT::getSubFolders.3x
Langue: en
Version: 11/28/2008 (fedora - 01/12/10)
Section: 3 (Bibliothèques de fonctions)
NAME
mail::ACCOUNT::getSubFolders - Enumerate subfoldersSYNOPSIS
-
#include <libmail/sync.H> mail::ACCOUNT *mail; const mail::folder *folder; mail::ACCOUNT::FolderList folderList;
- bool ok=mail->getSubFolders(folder, folderList);
-
-
- std::string errmsg=mail->getErrmsg();
-
size_t nFolders=folderList::size(); const mail::folder *folder=folderList[n];
-
USAGE
A mail account contains folders that are arranged in a tree-like hierarchy. mail::ACCOUNT::getSubFolders enumerates folder's subfolders (folder is obtained from a previous mail::ACCOUNT::getSubFolders or a mail::ACCOUNT::getTopLevelFolders(3x) call).
Note
Use mail::folder::hasSubFolders(3x) to check if folder contains subfolders, and invoke mail::ACCOUNT::getSubFolders only if mail::folder::hasSubFolders returns true.
RETURN CODES AND CALLBACKS
This method returns true if it succeeds, or false if it fails. If the method fails, use mail::ACCOUNT::getErrmsg() to read a brief description of the error.
See mail::ACCOUNT::getTopLevelFolders(3x) for additional notes and instructions on handling folder lists.
SEE ALSO
mail::ACCOUNT::getParentFolder(3x), mail::ACCOUNT::getTopLevelFolders(3x).
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre