C++ default constructor.

Destructor.

Removes the oldest entry from the mru list and adds given address info to the mru list.

DEPRECATED

Function to append mru entry to the mru list. This implementation adds display name and then the address in this order into the mru list.

Cancels current search. Does nothing if there is not any search ongoing. The search client will not be called back after this function is called.

note CancelSearch() method does NOT clear the search result cached in the store. A different sort order can be used for the same search string, and the cache will be utilized. Only by using a different search string can the cache be cleaned.

cancels all ongoing synchronizations in this mailbox regardless of initiator, by user or by plugin itself

Inform the store to clean up its cache for search results.

This method cancels the the ongoing search (if exists), and then clean ups store's cache.

This function should be called by the UI when search results are no longer in display.

Two-phased constructor

Function used to copy array contents to another array.

Copies a messages from one folder to another folder. including the properties, content, and all attachments. (note only works if the store is in an authenticated state, otherwise this function leaves with KErrNotReady)

creates into this mailbox new draft email to be forwarded

creates email from RFC822 format data stream located in given attachment file

return new email object, ownership is transferred to user

creates into this mailbox new draft email

creates into this mailbox new email for reply

Returns the current synchronizing state of this mailbox.

Returns extension by uid, leaves KErrNotSupported if extension is not available.

Function used to search an address from given mru list. Fucntion goes through the addresses in the mru list and returns the first one matching the given address.

Branding id accessor for this mailbox. This function is used by Branding Manager to associate mailbox to a branding definition.

reads connection id from plugin

Returns last synchronizing operation progress status.

mailbox connection status accessor

Standard folder id accessor.

Disables mailbox synchronization. Connection to server in order to synchronize the mailbox is not allowed after this.

If GoOnlineL has effect on other mailboxes using the same connection then this function has effect on those mailboxes also.

Enables synchronization of the mailbox. This means that the framework can connect to server to do synchronization of the mailbox when necessary or stay connected all the time. The actual functionality depends on user settings and connection implementation.

All collections (mail etc.) supported by the connection and enabled by user settings are synchronized.

This function sets the mailbox online but it may have a side effect that also other mailboxes provided through the same connection are set online too.

Connection is set offline normally by using specific function for this purpose. There are also other reasons for ending up in offline state like network error or scheduling.

mailbox capability check for user

checks from plugin if connection is allowed when roaming

List subfolders of given folder. Only direct subfolders of given folder are returned.

List all subfolders of mailbox.

Get a list of most recently used addresses of this mailbox. Each MRU entry consists of two descriptors placed sequentially in the array. First one is the display name and the second one is the actual email address. If for example some entry does not contain a name at all then a KNullDesC is found in place of the name.

Moves a messages between folders.

Moves a messages between folders. Async version.

two based constructor

two based constructor

Forces synchronization of mailbox. This can be called whether the mailbox is currently offline or online. In the case the mailbox is offline in the beginning, connection is made up for the time of the synchronization.

All collections (mail etc.) supported by the connection and enabled by user settings are synchronized.

This is an asynchronous operation and the request id is returned for cancelling purpose.

User can provide an observer as a parameter, which will pass progress notifications during the operation as callbacks related to this operation.

Alternatively user can use overloaded parallel implementation of function without an observer function and rely only on general events. Notice that the general event system is not as comprehensive as the observing using dedicated observer.

CExtendableEmail::ReleaseExtension()

removes downloaded attachments from local/terminal memory

Asyncronous call for starting search for given string. Only one search can be performed at a time.

This function will search for message's containing the given search string. The search will be performed on the all message fields: To, Cc, Bcc, subject, body. The search client will be notified of each found message, and upon completion of the search. Only one search can be performed at a time.

To change the sort order in the search result, use the same search string in the but change the aSortCriteria parameter. The store "caches" the search results generated by the same search string.

The function will leave with KErrInUse if a search is already in progress.

note only works if the store is in an authenticated state, otherwise this function leaves with KErrNotReady

sends email

Function to set the already existing entry in the mru list as the most recent one.

mailbox authentication data mutator

Function used to update given mru list with recently used address info. If this info is already found from the mru list then it is moved to the end of the mru list. This way the most recent ones are found from the end of the list.

Function used internally to inform that Mru list related to this mailbox should now be updated using the given recipient info. In other words this function makes sure that the given recipients are found from the mru list in which the mrus of this mailbox are stored. Mrus are stored in the plugin.

mailbox folder list

request handler for plugin requests