mail::folder::destroy
Prev | mail::folder Native API reference | Next

## Name

mail::folder::destroy — Destroy an existing folder

## Synopsis

#include <libmail/mail.H>
class myCallback : public mail::callback {
public:
void success(std::string msg);
void fail(std::string msg);
};

`folder->fsfunccreate(` | myCallback &callback,
| bool destroyDir`)`;

## USAGE

This function destroys the folder referenced by this mail::folder object. The mail::folder object itself is not destroyed (the usual C++ delete operator does the trick there), only the actual folder is destroyed.

Folders contain either messages, or other sub-folders (so-called "folder directories"). Some mail accounts may contain dual-purpose folders that contain both messages and sub-folders (see mail::account::createSubFolder(3x) for more information). With some account types, only completely empty folders may be deleted (the operation will fail if the folder still contains messages or other sub-folders).

`destroyDir` must be set to `true` when destroying a folder directory, and to `false` when destroying a regular folder.

## RETURN CODES AND CALLBACKS

The application must wait until `callback`'s `success` or `fail` method is invoked. The `success` method is invoked when this request is succesfully processed. The `fail` method is invoked if this request cannot be processed. The application must not destroy `callback` until either the `success` or `fail` method is invoked.

### Note

`callback`'s `fail` method may be invoked even after other callback methods were invoked. This indicates that the request was partially completed before the error was encountered.

## SEE ALSO

mail::account::createSubFolder(3x).

Prev | Up | Next
mail::folder::delRights | Home | ToC | mail::folder::getMyRights