1.1 --- a/epoc32/include/imapcmds.h Tue Nov 24 13:55:44 2009 +0000
1.2 +++ b/epoc32/include/imapcmds.h Tue Mar 16 16:12:26 2010 +0000
1.3 @@ -1,1 +1,1082 @@
1.4 -imapcmds.h
1.5 +// Copyright (c) 1998-2009 Nokia Corporation and/or its subsidiary(-ies).
1.6 +// All rights reserved.
1.7 +// This component and the accompanying materials are made available
1.8 +// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
1.9 +// which accompanies this distribution, and is available
1.10 +// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
1.11 +//
1.12 +// Initial Contributors:
1.13 +// Nokia Corporation - initial contribution.
1.14 +//
1.15 +// Contributors:
1.16 +//
1.17 +// Description:
1.18 +//
1.19 +
1.20 +#if !defined (__IMAPCMDS_H__)
1.21 +#define __IMAPCMDS_H__
1.22 +
1.23 +#if !defined (__MSVSTD_HRH__)
1.24 +#include <msvstd.hrh>
1.25 +#endif
1.26 +
1.27 +class TImap4RenameFolder
1.28 +/** Buffer for an IMAP folder name.
1.29 +
1.30 +@see KIMAP4MTMRenameFolder
1.31 +
1.32 +@publishedAll
1.33 +@released
1.34 +*/
1.35 + {
1.36 +public:
1.37 + /** IMAP folder name. */
1.38 + TBuf<128> iNewName;
1.39 + };
1.40 +
1.41 +/** IMAP4-specific commands that can be issued through either
1.42 +CImap4ClientMtm::InvokeAsyncFunctionL() or, in a few cases,
1.43 +CImap4ClientMtm::InvokeSyncFunctionL().
1.44 +
1.45 +These functions take an input message selection parameter
1.46 +(@c const CMsvEntrySelection& @c aSelection) and an input/output buffer parameter
1.47 +(TDes8& @c aParameter). The use of these parameters is command specific, and is
1.48 +described for each command below.
1.49 +
1.50 +The commands fall into a number of categories:
1.51 +
1.52 +- Connect and logon to remote server:
1.53 + - #KIMAP4MTMConnect
1.54 + - #KIMAP4MTMDisconnect
1.55 +- Synchronise headers:
1.56 + - #KIMAP4MTMCancelBackgroundSynchronise
1.57 + - #KIMAP4MTMConnectAndSyncCompleteAfterConnect
1.58 + - #KIMAP4MTMConnectAndSyncCompleteAfterDisconnect
1.59 + - #KIMAP4MTMConnectAndSyncCompleteAfterFullSync
1.60 + - #KIMAP4MTMConnectAndSynchronise
1.61 + - #KIMAP4MTMFolderFullSync
1.62 + - #KIMAP4MTMFullSync
1.63 + - #KIMAP4MTMInboxNewSync
1.64 + - #KIMAP4MTMSynchronise
1.65 + - #KIMAP4MTMWaitForBackground
1.66 +- Subscribe to mailboxes:
1.67 + - #KIMAP4MTMLocalSubscribe
1.68 + - #KIMAP4MTMLocalUnsubscribe
1.69 +- Populate messages:
1.70 + - #KIMAP4MTMPopulate
1.71 + - #KIMAP4MTMPopulateAllMailWhenAlreadyConnected
1.72 + - #KIMAP4MTMPopulateMailSelectionWhenAlreadyConnected
1.73 + - #KIMAP4MTMPopulateNewMailWhenAlreadyConnected
1.74 + - #KIMAP4MTMConnectAndPopulateAllMailAndDisconnect
1.75 + - #KIMAP4MTMConnectAndPopulateAllMailAndStayOnline
1.76 + - #KIMAP4MTMConnectAndPopulateMailSelectionAndDisconnect
1.77 + - #KIMAP4MTMConnectAndPopulateMailSelectionAndStayOnline
1.78 + - #KIMAP4MTMConnectAndPopulateNewMailAndDisconnect
1.79 + - #KIMAP4MTMConnectAndPopulateNewMailAndStayOnline
1.80 +- Copy messages:
1.81 + - #KIMAP4MTMCopyAllMailWhenAlreadyConnected
1.82 + - #KIMAP4MTMCopyMailSelectionWhenAlreadyConnected
1.83 + - #KIMAP4MTMCopyNewMailWhenAlreadyConnected
1.84 + - #KIMAP4MTMConnectAndCopyAllMailAndDisconnect
1.85 + - #KIMAP4MTMConnectAndCopyAllMailAndStayOnline
1.86 + - #KIMAP4MTMConnectAndCopyMailSelectionAndDisconnect
1.87 + - #KIMAP4MTMConnectAndCopyMailSelectionAndStayOnline
1.88 + - #KIMAP4MTMConnectAndCopyNewMailAndDisconnect
1.89 + - #KIMAP4MTMConnectAndCopyNewMailAndStayOnline
1.90 +- Move messages:
1.91 + - #KIMAP4MTMMoveAllMailWhenAlreadyConnected
1.92 + - #KIMAP4MTMMoveMailSelectionWhenAlreadyConnected
1.93 + - #KIMAP4MTMMoveNewMailWhenAlreadyConnected
1.94 + - #KIMAP4MTMConnectAndMoveAllMailAndDisconnect
1.95 + - #KIMAP4MTMConnectAndMoveAllMailAndStayOnline
1.96 + - #KIMAP4MTMConnectAndMoveMailSelectionAndDisconnect
1.97 + - #KIMAP4MTMConnectAndMoveMailSelectionAndStayOnline
1.98 + - #KIMAP4MTMConnectAndMoveNewMailAndDisconnect
1.99 + - #KIMAP4MTMConnectAndMoveNewMailAndStayOnline
1.100 +- Create messages:
1.101 + - #KIMAP4MTMCreateForwardAsAttachmentEmailMessage
1.102 + - #KIMAP4MTMCreateForwardEmailMessage
1.103 + - #KIMAP4MTMCreateNewEmailMessage
1.104 + - #KIMAP4MTMCreateReceiptEmailMessage
1.105 + - #KIMAP4MTMCreateReplyEmailMessage
1.106 + .
1.107 + Note that CImEmailOperation is usually a more convenient way
1.108 + to create messages.
1.109 +- Query state:
1.110 + - #KIMAP4MTMBusy
1.111 + - #KIMAP4MTMIsConnected
1.112 +- Offline operations:
1.113 + - #KIMAP4MTMCancelOffLineOperations
1.114 + - #KIMAP4MTMUndeleteAll
1.115 +- Miscellaneous:
1.116 + - #KIMAP4MTMEndBatch
1.117 + - #KIMAP4MTMRenameFolder
1.118 + - #KIMAP4MTMSelect
1.119 + - #KIMAP4MTMStartBatch
1.120 +
1.121 +Note that when @c iServiceSelection is referred to in code examples for some
1.122 +commands, this is assumed to be a CMsvEntrySelection that
1.123 +contain the entry ID of an IMAP service.
1.124 +
1.125 +@see CImap4ClientMtm::InvokeAsyncFunctionL()
1.126 +@see CImap4ClientMtm::InvokeSyncFunctionL()
1.127 +
1.128 +@publishedAll
1.129 +@released
1.130 +*/
1.131 +enum TImap4Cmds {
1.132 + /** Tests if a specified service is connected.
1.133 +
1.134 + This command is synchronous, and used from @c InvokeSyncFunctionL().
1.135 +
1.136 + @c aSelection: @c aSelection[0] should contain the entry ID of the service
1.137 + to test.
1.138 +
1.139 + @c aParameter: a packaged TInt. On return, this is set to
1.140 + KErrNone if the service is connected or KErrDisconnected if not.
1.141 +
1.142 + Example:
1.143 + @code
1.144 + TPckgBuf<TInt> parameter;
1.145 + iClientMtm->InvokeSyncFunctionL(KIMAP4MTMIsConnected, *iServiceSelection, parameter);
1.146 + if (parameter()==KErrNone)
1.147 + {
1.148 + _LIT(KConnStatus, "\n\n Connected to the service");
1.149 + iConsole->Printf(KConnStatus);
1.150 + }
1.151 + @endcode
1.152 + */
1.153 + KIMAP4MTMIsConnected = KMtmFirstFreeMtmFunctionId,
1.154 +
1.155 + /** Connects to the specified IMAP service.
1.156 +
1.157 + This makes a network connection and logs on the IMAP server specified
1.158 + in the settings for the service.
1.159 +
1.160 + @c aSelection: @c aSelection[0] should contain the entry ID of the service
1.161 + to connect to.
1.162 +
1.163 + @c aParameter: packages a pointer to an implementation of the connection observer
1.164 + interface, MMsvImapConnectionObserver. Callbacks are made to this interface
1.165 + to notify the client of the stages of connection.
1.166 +
1.167 + Completion: KErrBusy if the device is already connected to the specified server.
1.168 +
1.169 + Example:
1.170 + @code
1.171 + TBuf8<1> parameter;
1.172 + iOperation = iClientMtm->InvokeAsyncFunctionL(KIMAP4MTMConnect, *iServiceSelection, parameter, iStatus);
1.173 + @endcode
1.174 + */
1.175 + KIMAP4MTMConnect,
1.176 +
1.177 + /** Connects to the specified IMAP service, and starts a background synchronisation.
1.178 +
1.179 + The call completes when the connection occurs and the synchronisation starts. See
1.180 + CImap4ClientMtm for a description of a background synchronisation.
1.181 +
1.182 + @c aSelection: @c aSelection[0] should contain the entry ID of the service
1.183 + to connect to.
1.184 +
1.185 + @c aParameter: packages a pointer to an implementation of the connection observer
1.186 + interface, MMsvImapConnectionObserver. Callbacks are made to this interface
1.187 + to notify the client of the stages of connection and synchronisation.
1.188 +
1.189 + Completion: KErrBusy if the device is already connected to the specified server.
1.190 +
1.191 + Example:
1.192 + @code
1.193 + TPckg<MMsvImapConnectionObserver*> parameter(this);
1.194 + iOperation = iClientMtm->InvokeAsyncFunctionL(KIMAP4MTMConnectAndSynchronise, *iServiceSelection, parameter, iStatus);
1.195 + @endcode
1.196 + */
1.197 + KIMAP4MTMConnectAndSynchronise,
1.198 +
1.199 + /** Cancels a background synchronisation in progress.
1.200 +
1.201 + @c aSelection: @c aSelection[0] should contain the entry ID of the service
1.202 + being synchronised.
1.203 +
1.204 + @c aParameter: unused.
1.205 +
1.206 + Completion: KErrCancel if a synchronisation was cancelled; KErrNone if no
1.207 + synchronisation was taking place.
1.208 +
1.209 + Example:
1.210 + @code
1.211 + TBuf8<1> parameter;
1.212 + iOperation = iClientMtm->InvokeAsyncFunctionL(KIMAP4MTMCancelBackgroundSynchronise, *iServiceSelection, parameter, iStatus);
1.213 + @endcode
1.214 + */
1.215 + KIMAP4MTMCancelBackgroundSynchronise,
1.216 +
1.217 + /** Ensures that the IMAP server will remain loaded ready for more commands.
1.218 +
1.219 + If this is not set, then the Message Server can unload the IMAP server MTM
1.220 + after a service is disconnected. It is more efficient if it stays loaded
1.221 + if further use of the MTM is expected.
1.222 +
1.223 + @c aSelection: @c aSelection[0] should contain the TMsvId of the IMAP4service.
1.224 +
1.225 + @c aParameter: unused.
1.226 +
1.227 + Completion: KErrNone.
1.228 + */
1.229 + KIMAP4MTMStartBatch,
1.230 +
1.231 + /** Ends the effect of KIMAP4MTMStartBatch.
1.232 +
1.233 + @c aSelection: @c aSelection[0] should contain the TMsvId of the IMAP4service.
1.234 +
1.235 + @c aParameter: unused.
1.236 +
1.237 + Completion: KErrNone.
1.238 + */
1.239 + KIMAP4MTMEndBatch,
1.240 +
1.241 + /** Tests if the server is busy.
1.242 +
1.243 + It can be used from either CImap4ClientMtm::InvokeAsyncFunctionL() or
1.244 + CImap4ClientMtm::InvokeSyncFunctionL().
1.245 +
1.246 + @c aSelection: @c aSelection[0] should contain the TMsvId of the IMAP4service.
1.247 +
1.248 + @c aParameter: if the command is called from InvokeSyncFunctionL(), then on return a packaged
1.249 + TInt holding the result.
1.250 +
1.251 + Completion: This completes with either KErrNone (neither session is busy) or KErrServerBusy
1.252 + otherwise.
1.253 + */
1.254 + KIMAP4MTMBusy,
1.255 +
1.256 + /** Issues an IMAP SELECT command on the specified mailbox.
1.257 +
1.258 + This is used to select an mailbox for the KIMAP4MTMSynchronise command.
1.259 +
1.260 + Pre-condition: a connected service.
1.261 +
1.262 + @c aSelection: @c aSelection[0] should contain the entry ID of the folder
1.263 + to select.
1.264 +
1.265 + @c aParameter: Unused.
1.266 +
1.267 + Completion: KErrDisconnected if not connected.
1.268 + */
1.269 + KIMAP4MTMSelect,
1.270 +
1.271 + /** Synchronises the current folder that is selected on the remote server.
1.272 +
1.273 + Note that after a connection is made, the Inbox folder is selected by default.
1.274 +
1.275 + Pre-condition: a connected service.
1.276 +
1.277 + @c aSelection: @c aSelection[0] should contain the TMsvId of the IMAP4service.
1.278 +
1.279 + @c aParameter: unused.
1.280 +
1.281 + Completion: KErrDisconnected if not connected.
1.282 + */
1.283 + KIMAP4MTMSynchronise,
1.284 +
1.285 + /** Synchronises the connected service's folder tree with the folders on the remote IMAP server.
1.286 +
1.287 + This creates and deletes folder entries in the message store under the remote service as needed,
1.288 + to match the mailboxes that exist on the remote server. Note that this step is done as part of
1.289 + the normal service synchronisation operation.
1.290 +
1.291 + Pre-condition: a connected service.
1.292 +
1.293 + @c aSelection: @c aSelection[0] should contain the TMsvId of the IMAP4service.
1.294 +
1.295 + @c aParameter: unused.
1.296 +
1.297 + Completion: KErrDisconnected if not connected; KErrServerBusy if a
1.298 + background synchronisation is already in progress.
1.299 + */
1.300 + KIMAP4MTMSyncTree,
1.301 +
1.302 + /** Not supported. */
1.303 + KIMAP4MTMReserved10, // SyncSubscription
1.304 +
1.305 + /** Synchronises the specified service.
1.306 +
1.307 + This is a foreground synchronisation, and completes when the synchronisation is done.
1.308 +
1.309 + @c aSelection: @c aSelection[0] should contain the entry ID of the service
1.310 + to synchronise.
1.311 +
1.312 + @c aParameter: unused.
1.313 +
1.314 + Pre-condition: a connected service.
1.315 +
1.316 + Completion: KErrDisconnected if not connected; KErrServerBusy if a
1.317 + background synchronisation is already in progress.
1.318 + */
1.319 + KIMAP4MTMFullSync,
1.320 +
1.321 + /** Cancels any operations in progress and sends logout messages to server.
1.322 +
1.323 + If CImImap4Settings::SetDeleteEmailsWhenDisconnecting() is set,
1.324 + any messages marked as deleted while offline are deleted before logout.
1.325 +
1.326 + Pre-condition: a connected service.
1.327 +
1.328 + @c aSelection: @c aSelection[0] should contain the TMsvId of the IMAP4service.
1.329 +
1.330 + @c aParameter: unused.
1.331 +
1.332 + Completion: KErrDisconnected if not connected.
1.333 + */
1.334 + KIMAP4MTMDisconnect,
1.335 +
1.336 + /** Sets the local subscription flag on a specified folder.
1.337 +
1.338 + This sets the local subscription flag on the folder's index entry
1.339 + (see TMsvEmailEntry::SetLocalSubscription()), and saves the changed entry
1.340 + to the index.
1.341 +
1.342 + @c aSelection: @c aSelection[0] should contain the entry ID of the folder
1.343 + to subscribe to.
1.344 +
1.345 + @c aParameter: unused.
1.346 +
1.347 + Completion: KErrNotSupported if the entry is not a folder; KErrNone on success.
1.348 + */
1.349 + KIMAP4MTMLocalSubscribe,
1.350 +
1.351 + /** Clears the local subscription flag on the specified folder.
1.352 +
1.353 + @c aSelection: @c aSelection[0] should contain the entry ID of the folder
1.354 + to unsubscribe from.
1.355 +
1.356 + @c aParameter: unused.
1.357 +
1.358 + Completion: KErrNotSupported if the entry is not a folder; KErrNone on success.
1.359 + */
1.360 + KIMAP4MTMLocalUnsubscribe,
1.361 +
1.362 + /** Not supported. */
1.363 + KIMAP4MTMReserved15, // MakeRemoteMailboxesInvisible
1.364 + /** Not supported. */
1.365 + KIMAP4MTMReserved16, // MakeRemoteMailboxesVisible
1.366 +
1.367 + /** Synchronises any messages received by the remote server Inbox since the
1.368 + last synchronisation operation.
1.369 +
1.370 + Messages that have been deleted from the remote Inbox are not deleted from
1.371 + the mirror.
1.372 +
1.373 + Pre-condition: a connected service.
1.374 +
1.375 + @c aSelection: @c aSelection[0] should contain the TMsvId of the IMAP4service.
1.376 +
1.377 + @c aParameter: unused.
1.378 +
1.379 + Completion: KErrDisconnected if not connected; KErrServerBusy if a
1.380 + background synchronisation is already in progress.
1.381 + */
1.382 + KIMAP4MTMInboxNewSync,
1.383 +
1.384 + /** Selects and synchronises the specified folder.
1.385 +
1.386 + Pre-condition: a connected service.
1.387 +
1.388 + @c aSelection: @c aSelection[0] should contain the entry ID of the folder to synchronise.
1.389 +
1.390 + @c aParameter: unused.
1.391 +
1.392 + Completion: KErrDisconnected if not connected.
1.393 + */
1.394 + KIMAP4MTMFolderFullSync,
1.395 +
1.396 + /** Completes only when a background synchronisation has finished.
1.397 +
1.398 + This turns a background synchronisation into a foreground synchronisation.
1.399 +
1.400 + @c aSelection: @c aSelection[0] should contain the entry ID of the service
1.401 + being synchronised.
1.402 +
1.403 + @c aParameter: unused.
1.404 +
1.405 + Completion: KErrNone when no background synchronisation is in progress.
1.406 +
1.407 + Example:
1.408 + @code
1.409 + TBuf8<1> parameter;
1.410 + iOperation = iClientMtm->InvokeAsyncFunctionL(KIMAP4MTMWaitForBackground, *iServiceSelection, parameter, iStatus);
1.411 + @endcode
1.412 + */
1.413 + KIMAP4MTMWaitForBackground,
1.414 +
1.415 + /** Renames a specified folder.
1.416 +
1.417 + @c aSelection: @c aSelection[0] should contain the entry ID of the folder to rename.
1.418 +
1.419 + @c aParameter: the new name for the folder. This should be a packaged TImap4RenameFolder object.
1.420 +
1.421 + Pre-conditions: a connected service.
1.422 +
1.423 + Completion: KErrDisconnected if there is no connected service.
1.424 +
1.425 + Example:
1.426 + @code
1.427 + // rename folder, assumed to be identified in *selection[0], to "newname".
1.428 + _LIT(KNewName, "newname");
1.429 + TImap4RenameFolder newName;
1.430 + newName.iNewName = KNewName;
1.431 + TPckg<TImap4RenameFolder> name(newName);
1.432 + iOperation = iClientMtm->InvokeAsyncFunctionL(KIMAP4MTMRenameFolder, *selection, name, iStatus);
1.433 + @endcode
1.434 + */
1.435 + KIMAP4MTMRenameFolder,
1.436 +
1.437 + /** Undoes any offline delete operations pending on the specified entries.
1.438 +
1.439 + @c aSelection: Entries on which to cancel offline delete operations.
1.440 +
1.441 + @c aParameter: Unused.
1.442 +
1.443 + Completion: KErrNone.
1.444 + */
1.445 + KIMAP4MTMUndeleteAll,
1.446 +
1.447 + /** Cancels any offline operations pending on the specified entries.
1.448 +
1.449 + If any item is a folder, then it cancels all operations queued on any item
1.450 + in that folder. If an IMAP4 service ID is given, then it cancels any Copy()
1.451 + or MoveFromLocal() operations that are queued. A message can not have its
1.452 + pending operations cancelled individually.
1.453 +
1.454 + @c aSelection: Entries on which to cancel offline operations.
1.455 +
1.456 + @c aParameter: Unused.
1.457 +
1.458 + Completion: KErrNone.
1.459 + */
1.460 + KIMAP4MTMCancelOffLineOperations,
1.461 +
1.462 + /** Fetches the specified messages from the remote server to the mirror.
1.463 +
1.464 + @c aSelection: Messages to fetch.
1.465 +
1.466 + @c aParameter: A packaged TImImap4GetPartialMailInfo or TImImap4GetMailInfo
1.467 + specifying the message parts to fetch and size limits on what is fetched.
1.468 +
1.469 + */
1.470 + KIMAP4MTMPopulate,
1.471 +
1.472 + /** Not supported. */
1.473 + KIMAP4MTMSyncSubscription,
1.474 +
1.475 + /** Connect and synchronise the specified service, and complete after connection.
1.476 +
1.477 + The operation completes when the connection part completes. The synchronisation
1.478 + is done in the background.
1.479 +
1.480 + The command has the same functionality as KIMAP4MTMConnectAndSynchronise.
1.481 +
1.482 + @c aSelection: @c aSelection[0] should contain the entry ID of the service
1.483 + to connect to.
1.484 +
1.485 + @c aParameter: packages a pointer to an implementation of the connection observer
1.486 + interface, MMsvImapConnectionObserver. Callbacks are made to this interface
1.487 + to notify the client of the stages of connection and synchronisation.
1.488 +
1.489 + Completion: KErrBusy if a connected session already exists.
1.490 + */
1.491 + KIMAP4MTMConnectAndSyncCompleteAfterConnect,
1.492 +
1.493 + /** Connect and synchronise the specified service, and complete after synchronisation.
1.494 +
1.495 + This is similar to KIMAP4MTMConnectAndSynchronise, except that the operation
1.496 + does not complete until synchronisation is complete.
1.497 +
1.498 + @c aSelection: @c aSelection[0] should contain the entry ID of the service
1.499 + to connect to.
1.500 +
1.501 + @c aParameter: packages a pointer to an implementation of the connection observer
1.502 + interface, MMsvImapConnectionObserver. Callbacks are made to this interface
1.503 + to notify the client of the stages of connection and synchronisation.
1.504 +
1.505 + Completion: KErrBusy if a connected session already exists.
1.506 + */
1.507 + KIMAP4MTMConnectAndSyncCompleteAfterFullSync,
1.508 +
1.509 + /** Connect and synchronise the specified service, and complete after disconnection.
1.510 +
1.511 + Unlike the other synchronisation commands, this command does not complete
1.512 + after either connection or synchronisation. Instead, after the initial synchronisation
1.513 + is complete, it periodically resynchronises the Inbox until the service is disconnected.
1.514 + CImImap4Settings::SyncRate() sets the refresh period.
1.515 +
1.516 + Disconnection can occur because the network connection is closed, either through
1.517 + user action, or because a networking timeout occurs on the socket.
1.518 +
1.519 + @c aSelection: @c aSelection[0] should contain the entry ID of the service
1.520 + to connect to.
1.521 +
1.522 + @c aParameter: packages a pointer to an implementation of the connection
1.523 + observer interface, MMsvImapConnectionObserver. Callbacks are made to this
1.524 + interface to notify the client of the stages of connection and
1.525 + synchronisation.
1.526 +
1.527 + Completion: KErrBusy if a connected session already exists.
1.528 + */
1.529 + KIMAP4MTMConnectAndSyncCompleteAfterDisconnect,
1.530 +
1.531 + /** Not supported. */
1.532 + KIMAP4MTMCancelSendOnNextConnection,
1.533 +
1.534 + /** Copy any new messages from a specified folder to another folder,
1.535 + assuming a new connection does not need to be made.
1.536 +
1.537 + This is used after message headers have been synchronised. Any messages marked
1.538 + as new are populated in the mirror, and then copied to the specified destination folder.
1.539 +
1.540 + Pre-condition: a connected service.
1.541 +
1.542 + @c aSelection: @c aSelection[0] should contain the entry ID of the service;
1.543 + @c aSelection[1] should contain the entry ID of the folder from which
1.544 + to copy the entries.
1.545 +
1.546 + @c aParameter: packaged TImImap4GetMailInfo object.
1.547 + TImImap4GetMailInfo::iDestinationFolder specifies the folder into which to
1.548 + copy the new messages. Messages with a size greater than TImImap4GetMailInfo::iMaxEmailSize
1.549 + are not copied. TImImap4GetMailInfo::iGetMailBodyParts is ignored:
1.550 + the entire message is always fetched.
1.551 +
1.552 + Completion: note if there are no new entries, then KErrNone, and progress
1.553 + information is a null descriptor.
1.554 + */
1.555 + KIMAP4MTMCopyNewMailWhenAlreadyConnected,
1.556 +
1.557 + /** Connect to a specified service, copy any new messages from
1.558 + a specified folder into another folder, and stay connected.
1.559 +
1.560 + @c aSelection: @c aSelection[0] should contain the entry ID of the service;
1.561 + @c aSelection[1] should contain the entry ID of the folder containing
1.562 + the messages to copy.
1.563 +
1.564 + @c aParameter: packaged TImImap4GetMailInfo object.
1.565 + TImImap4GetMailInfo::iDestinationFolder specifies the folder into which to
1.566 + copy the new messages. Messages with a size greater than TImImap4GetMailInfo::iMaxEmailSize
1.567 + are not copied. TImImap4GetMailInfo::iGetMailBodyParts is ignored:
1.568 + the entire message is always fetched.
1.569 +
1.570 + Completion: note if there are no new entries, then KErrNone, and progress
1.571 + information is a null descriptor.
1.572 + */
1.573 + KIMAP4MTMConnectAndCopyNewMailAndStayOnline,
1.574 +
1.575 + /** Connect to a specified service, copy any new messages from
1.576 + a specified folder into another folder, and disconnect afterwards.
1.577 +
1.578 + @c aSelection: @c aSelection[0] should contain the entry ID of the service;
1.579 + @c aSelection[1] should contain the entry ID of the folder containing
1.580 + the messages to copy.
1.581 +
1.582 + @c aParameter: packaged TImImap4GetMailInfo object.
1.583 + TImImap4GetMailInfo::iDestinationFolder specifies the folder into which to
1.584 + copy the new messages. Messages with a size greater than TImImap4GetMailInfo::iMaxEmailSize
1.585 + are not copied. TImImap4GetMailInfo::iGetMailBodyParts is ignored:
1.586 + the entire message is always fetched.
1.587 +
1.588 + Completion: note if there are no new entries, then KErrNone, and progress
1.589 + information is a null descriptor.
1.590 + */
1.591 + KIMAP4MTMConnectAndCopyNewMailAndDisconnect,
1.592 +
1.593 + /** Move any new messages from a specified folder to another folder,
1.594 + assuming a new connection does not need to be made.
1.595 +
1.596 + This is used after message headers have been synchronised. Any messages marked
1.597 + as new are populated in the mirror, and then moved to the specified destination folder.
1.598 +
1.599 + Pre-condition: a connected service.
1.600 +
1.601 + @c aSelection: @c aSelection[0] should contain the entry ID of the service;
1.602 + @c aSelection[1] should contain the entry ID of the folder from which
1.603 + to move the entries.
1.604 +
1.605 + @c aParameter: packaged TImImap4GetMailInfo object.
1.606 + TImImap4GetMailInfo::iDestinationFolder specifies the folder into which to
1.607 + move the new messages. Messages with a size greater than TImImap4GetMailInfo::iMaxEmailSize
1.608 + are not moved. TImImap4GetMailInfo::iGetMailBodyParts is ignored:
1.609 + the entire message is always fetched.
1.610 +
1.611 + Completion: note if there are no new entries, then KErrNone, and progress
1.612 + information is a null descriptor.
1.613 + */
1.614 + KIMAP4MTMMoveNewMailWhenAlreadyConnected,
1.615 +
1.616 + /** Connect to a specified service, move any new messages from
1.617 + a specified folder into another folder, and stay connected.
1.618 +
1.619 + @c aSelection: @c aSelection[0] should contain the entry ID of the service;
1.620 + @c aSelection[1] should contain the entry ID of the folder containing
1.621 + the messages to move.
1.622 +
1.623 + @c aParameter: packaged TImImap4GetMailInfo object.
1.624 + TImImap4GetMailInfo::iDestinationFolder specifies the folder into which to
1.625 + move the new messages. Messages with a size greater than TImImap4GetMailInfo::iMaxEmailSize
1.626 + are not copied. TImImap4GetMailInfo::iGetMailBodyParts is ignored:
1.627 + the entire message is always fetched.
1.628 +
1.629 + Completion: note if there are no new entries, then KErrNone, and progress
1.630 + information is a null descriptor.
1.631 + */
1.632 + KIMAP4MTMConnectAndMoveNewMailAndStayOnline,
1.633 +
1.634 + /** Connect to a specified service, move any new messages from
1.635 + a specified folder into another folder, and disconnect afterwards.
1.636 +
1.637 + @c aSelection: @c aSelection[0] should contain the entry ID of the service;
1.638 + @c aSelection[1] should contain the entry ID of the folder containing
1.639 + the messages to move.
1.640 +
1.641 + @c aParameter: packaged TImImap4GetMailInfo object.
1.642 + TImImap4GetMailInfo::iDestinationFolder specifies the folder into which to
1.643 + move the new messages. Messages with a size greater than TImImap4GetMailInfo::iMaxEmailSize
1.644 + are not copied. TImImap4GetMailInfo::iGetMailBodyParts is ignored:
1.645 + the entire message is always fetched.
1.646 +
1.647 + Completion: note if there are no new entries, then KErrNone, and progress
1.648 + information is a null descriptor.
1.649 + */
1.650 + KIMAP4MTMConnectAndMoveNewMailAndDisconnect,
1.651 +
1.652 + /** Copy the specified messages to another folder, assuming a new connection
1.653 + does not need to be made.
1.654 +
1.655 + The specified messages are populated in the mirror, and then copied to
1.656 + the specified destination folder.
1.657 +
1.658 + Pre-condition: a connected service.
1.659 +
1.660 + @c aSelection: @c aSelection[0] should contain the entry ID of the service,
1.661 + followed by the IDs of the messages to copy.
1.662 +
1.663 + @c aParameter: packaged TImImap4GetMailInfo object.
1.664 + TImImap4GetMailInfo::iDestinationFolder specifies the folder into which to
1.665 + copy the new messages. Messages with a size greater than TImImap4GetMailInfo::iMaxEmailSize
1.666 + are not copied. TImImap4GetMailInfo::iGetMailBodyParts is ignored:
1.667 + the entire message is always fetched.
1.668 +
1.669 + Completion: note if there are no entries to copy, then KErrNone, and progress
1.670 + information is a null descriptor.
1.671 + */
1.672 + KIMAP4MTMCopyMailSelectionWhenAlreadyConnected,
1.673 +
1.674 + /** Connect to a specified service, copy the specified messages to another
1.675 + folder, and stay connected.
1.676 +
1.677 + The specified messages are populated in the mirror, and then copied to
1.678 + the specified destination folder.
1.679 +
1.680 + @c aSelection: @c aSelection[0] should contain the entry ID of the service,
1.681 + followed by the IDs of the messages to copy.
1.682 +
1.683 + @c aParameter: packaged TImImap4GetMailInfo object.
1.684 + TImImap4GetMailInfo::iDestinationFolder specifies the folder into which to
1.685 + copy the new messages. Messages with a size greater than TImImap4GetMailInfo::iMaxEmailSize
1.686 + are not copied. TImImap4GetMailInfo::iGetMailBodyParts is ignored:
1.687 + the entire message is always fetched.
1.688 +
1.689 + Completion: note if there are no entries to copy, then KErrNone, and progress
1.690 + information is a null descriptor.
1.691 + */
1.692 + KIMAP4MTMConnectAndCopyMailSelectionAndStayOnline,
1.693 +
1.694 + /** Connect to a specified service, copy the specified messages to another
1.695 + folder, and disconnect afterwards.
1.696 +
1.697 + The specified messages are populated in the mirror, and then copied to
1.698 + the specified destination folder.
1.699 +
1.700 + @c aSelection: @c aSelection[0] should contain the entry ID of the service,
1.701 + followed by the IDs of the messages to copy.
1.702 +
1.703 + @c aParameter: packaged TImImap4GetMailInfo object.
1.704 + TImImap4GetMailInfo::iDestinationFolder specifies the folder into which to
1.705 + copy the new messages. Messages with a size greater than TImImap4GetMailInfo::iMaxEmailSize
1.706 + are not copied. TImImap4GetMailInfo::iGetMailBodyParts is ignored:
1.707 + the entire message is always fetched.
1.708 +
1.709 + Completion: note if there are no entries to copy, then KErrNone, and progress
1.710 + information is a null descriptor.
1.711 + */
1.712 + KIMAP4MTMConnectAndCopyMailSelectionAndDisconnect,
1.713 +
1.714 + /** Move the specified messages to another folder, assuming a new connection
1.715 + does not need to be made.
1.716 +
1.717 + Pre-condition: a connected service.
1.718 +
1.719 + @c aSelection: @c aSelection[0] should contain the entry ID of the service,
1.720 + followed by the IDs of the messages to move.
1.721 +
1.722 + @c aParameter: packaged TImImap4GetMailInfo object.
1.723 + TImImap4GetMailInfo::iDestinationFolder specifies the folder into which to
1.724 + move the messages. Messages with a size greater than TImImap4GetMailInfo::iMaxEmailSize
1.725 + are not moved. TImImap4GetMailInfo::iGetMailBodyParts is ignored:
1.726 + the entire message is always fetched.
1.727 +
1.728 + Completion: note if there are no entries to move, then KErrNone, and progress
1.729 + information is a null descriptor.
1.730 + */
1.731 + KIMAP4MTMMoveMailSelectionWhenAlreadyConnected,
1.732 +
1.733 + /** Connect to a specified service, move the specified messages to another
1.734 + folder, and stay connected.
1.735 +
1.736 + @c aSelection: @c aSelection[0] should contain the entry ID of the service,
1.737 + followed by the IDs of the messages to move.
1.738 +
1.739 + @c aParameter: packaged TImImap4GetMailInfo object.
1.740 + TImImap4GetMailInfo::iDestinationFolder specifies the folder into which to
1.741 + move the messages. Messages with a size greater than TImImap4GetMailInfo::iMaxEmailSize
1.742 + are not moved. TImImap4GetMailInfo::iGetMailBodyParts is ignored:
1.743 + the entire message is always fetched.
1.744 +
1.745 + Completion: note if there are no entries to move, then KErrNone, and progress
1.746 + information is a null descriptor.
1.747 + */
1.748 + KIMAP4MTMConnectAndMoveMailSelectionAndStayOnline,
1.749 +
1.750 + /** Connect to a specified service, move the specified messages to another
1.751 + folder, and disconnect afterwards.
1.752 +
1.753 + @c aSelection: @c aSelection[0] should contain the entry ID of the service,
1.754 + followed by the IDs of the messages to move.
1.755 +
1.756 + @c aParameter: packaged TImImap4GetMailInfo object.
1.757 + TImImap4GetMailInfo::iDestinationFolder specifies the folder into which to
1.758 + move the messages. Messages with a size greater than TImImap4GetMailInfo::iMaxEmailSize
1.759 + are not moved. TImImap4GetMailInfo::iGetMailBodyParts is ignored:
1.760 + the entire message is always fetched.
1.761 +
1.762 + Completion: note if there are no entries to move, then KErrNone, and progress
1.763 + information is a null descriptor.
1.764 + */
1.765 + KIMAP4MTMConnectAndMoveMailSelectionAndDisconnect,
1.766 +
1.767 + /** Copy all messages from the current service, assuming a new connection does
1.768 + not need to be made.
1.769 +
1.770 + Pre-condition: a connected service.
1.771 +
1.772 + @c aSelection: @c aSelection[0] should contain the entry ID of the service;
1.773 + @c aSelection[1] should contain the entry ID of the folder from which
1.774 + to copy the entries.
1.775 +
1.776 + @c aParameter: packaged TImImap4GetMailInfo object.
1.777 + TImImap4GetMailInfo::iDestinationFolder specifies the folder into which to
1.778 + copy the new messages. Messages with a size greater than TImImap4GetMailInfo::iMaxEmailSize
1.779 + are not copied. TImImap4GetMailInfo::iGetMailBodyParts is ignored:
1.780 + the entire message is always fetched.
1.781 +
1.782 + Completion: note if there are no entries to copy, then KErrNone, and progress
1.783 + information is a null descriptor.
1.784 + */
1.785 + KIMAP4MTMCopyAllMailWhenAlreadyConnected,
1.786 +
1.787 + /** Connect to a specified service, copy all messages from the current service,
1.788 + and stay connected.
1.789 +
1.790 + @c aSelection: @c aSelection[0] should contain the entry ID of the service;
1.791 + @c aSelection[1] should contain the entry ID of the folder from which
1.792 + to copy the entries.
1.793 +
1.794 + @c aParameter: packaged TImImap4GetMailInfo object.
1.795 + TImImap4GetMailInfo::iDestinationFolder specifies the folder into which to
1.796 + copy the new messages. Messages with a size greater than TImImap4GetMailInfo::iMaxEmailSize
1.797 + are not copied. TImImap4GetMailInfo::iGetMailBodyParts is ignored:
1.798 + the entire message is always fetched.
1.799 +
1.800 + Completion: note if there are no entries to copy, then KErrNone, and progress
1.801 + information is a null descriptor.
1.802 + */
1.803 + KIMAP4MTMConnectAndCopyAllMailAndStayOnline,
1.804 +
1.805 + /** Connect to a specified service, copy all messages from the current service,
1.806 + and disconnect afterwards.
1.807 +
1.808 + @c aSelection: @c aSelection[0] should contain the entry ID of the service;
1.809 + @c aSelection[1] should contain the entry ID of the folder from which
1.810 + to copy the entries.
1.811 +
1.812 + @c aParameter: packaged TImImap4GetMailInfo object.
1.813 + TImImap4GetMailInfo::iDestinationFolder specifies the folder into which to
1.814 + copy the new messages. Messages with a size greater than TImImap4GetMailInfo::iMaxEmailSize
1.815 + are not copied. TImImap4GetMailInfo::iGetMailBodyParts is ignored:
1.816 + the entire message is always fetched.
1.817 +
1.818 + Completion: note if there are no entries to copy, then KErrNone, and progress
1.819 + information is a null descriptor.
1.820 + */
1.821 + KIMAP4MTMConnectAndCopyAllMailAndDisconnect,
1.822 +
1.823 + /** Move all messages from the specified folder, assuming a new connection does
1.824 + not need to be made.
1.825 +
1.826 + Pre-condition: a connected service.
1.827 +
1.828 + @c aSelection: @c aSelection[0] should contain the entry ID of the service;
1.829 + @c aSelection[1] should contain the entry ID of the folder from which
1.830 + to move the entries.
1.831 +
1.832 + @c aParameter: packaged TImImap4GetMailInfo object.
1.833 + TImImap4GetMailInfo::iDestinationFolder specifies the folder into which to
1.834 + move the new messages. Messages with a size greater than TImImap4GetMailInfo::iMaxEmailSize
1.835 + are not moved. TImImap4GetMailInfo::iGetMailBodyParts is ignored:
1.836 + the entire message is always fetched.
1.837 +
1.838 + Completion: note if there are no entries to move, then KErrNone, and progress
1.839 + information is a null descriptor.
1.840 + */
1.841 + KIMAP4MTMMoveAllMailWhenAlreadyConnected,
1.842 +
1.843 + /** Connect to a specified service, move all messages from
1.844 + a specified folder into another folder, and stay connected.
1.845 +
1.846 + @c aSelection: @c aSelection[0] should contain the entry ID of the service;
1.847 + @c aSelection[1] should contain the entry ID of the folder containing
1.848 + the messages to move.
1.849 +
1.850 + @c aParameter: packaged TImImap4GetMailInfo object.
1.851 + TImImap4GetMailInfo::iDestinationFolder specifies the folder into which to
1.852 + move the new messages. Messages with a size greater than TImImap4GetMailInfo::iMaxEmailSize
1.853 + are not copied. TImImap4GetMailInfo::iGetMailBodyParts is ignored:
1.854 + the entire message is always fetched.
1.855 +
1.856 + Completion: note if there are no new entries, then KErrNone, and progress
1.857 + information is a null descriptor.
1.858 + */
1.859 + KIMAP4MTMConnectAndMoveAllMailAndStayOnline,
1.860 +
1.861 + /** Connect to a specified service, move all messages from
1.862 + a specified folder into another folder, and disconnect afterwards.
1.863 +
1.864 + @c aSelection: @c aSelection[0] should contain the entry ID of the service;
1.865 + @c aSelection[1] should contain the entry ID of the folder containing
1.866 + the messages to move.
1.867 +
1.868 + @c aParameter: packaged TImImap4GetMailInfo object.
1.869 + TImImap4GetMailInfo::iDestinationFolder specifies the folder into which to
1.870 + move the new messages. Messages with a size greater than TImImap4GetMailInfo::iMaxEmailSize
1.871 + are not copied. TImImap4GetMailInfo::iGetMailBodyParts is ignored:
1.872 + the entire message is always fetched.
1.873 +
1.874 + Completion: note if there are no new entries, then KErrNone, and progress
1.875 + information is a null descriptor.
1.876 + */
1.877 + KIMAP4MTMConnectAndMoveAllMailAndDisconnect,
1.878 +
1.879 + /** Populate the specified messages, assuming a new connection does not need to be made.
1.880 +
1.881 + Pre-condition: a connected service.
1.882 +
1.883 + @c aSelection: @c aSelection[0] should contain the entry ID of the service,
1.884 + followed by the IDs of the messages to populate.
1.885 +
1.886 + @c aParameter: A packaged TImImap4GetPartialMailInfo or TImImap4GetMailInfo
1.887 + specifying the message parts to fetch and size limits on what is fetched.
1.888 +
1.889 + Completion: note if there are no entries to populate, then KErrNone, and progress
1.890 + information is a null descriptor.
1.891 + */
1.892 + KIMAP4MTMPopulateMailSelectionWhenAlreadyConnected,
1.893 +
1.894 + /** Connect to a specified service, populate the specified messages,
1.895 + and stay connected.
1.896 +
1.897 + @c aSelection: @c aSelection[0] should contain the entry ID of the service,
1.898 + followed by the IDs of the messages to populate.
1.899 +
1.900 + @c aParameter: A packaged TImImap4GetPartialMailInfo or TImImap4GetMailInfo
1.901 + specifying the message parts to fetch and size limits on what is fetched.
1.902 +
1.903 + Completion: note if there are no entries to populate, then KErrNone, and progress
1.904 + information is a null descriptor.
1.905 + */
1.906 + KIMAP4MTMConnectAndPopulateMailSelectionAndStayOnline,
1.907 +
1.908 + /** Connect to a specified service, populate the specified messages,
1.909 + and disconnect afterwards.
1.910 +
1.911 + @c aSelection: @c aSelection[0] should contain the entry ID of the service,
1.912 + followed by the IDs of the messages to populate.
1.913 +
1.914 + @c aParameter: A packaged TImImap4GetPartialMailInfo or TImImap4GetMailInfo
1.915 + specifying the message parts to fetch and size limits on what is fetched.
1.916 +
1.917 + Completion: note if there are no entries to populate, then KErrNone, and progress
1.918 + information is a null descriptor.
1.919 + */
1.920 + KIMAP4MTMConnectAndPopulateMailSelectionAndDisconnect,
1.921 +
1.922 + /** Populate the new messages in a specified folder, assuming a new connection does
1.923 + not need to be made.
1.924 +
1.925 + Pre-condition: a connected service.
1.926 +
1.927 + @c aSelection: @c aSelection[0] should contain the entry ID of the service;
1.928 + @c aSelection[1] should contain the entry ID of the folder containing
1.929 + the messages to populate.
1.930 +
1.931 + @c aParameter: A packaged TImImap4GetPartialMailInfo or TImImap4GetMailInfo
1.932 + specifying the message parts to fetch and size limits on what is fetched.
1.933 +
1.934 + Completion: note if there are no entries to populate, then KErrNone, and progress
1.935 + information is a null descriptor.
1.936 + */
1.937 + KIMAP4MTMPopulateNewMailWhenAlreadyConnected,
1.938 +
1.939 + /** Populate all messages in a specified folder, assuming a new connection does
1.940 + not need to be made.
1.941 +
1.942 + Pre-condition: a connected service.
1.943 +
1.944 + @c aSelection: @c aSelection[0] should contain the entry ID of the service;
1.945 + @c aSelection[1] should contain the entry ID of the folder containing
1.946 + the messages to populate.
1.947 +
1.948 + @c aParameter: A packaged TImImap4GetPartialMailInfo or TImImap4GetMailInfo
1.949 + specifying the message parts to fetch and size limits on what is fetched.
1.950 +
1.951 + Completion: note if there are no entries to populate, then KErrNone, and progress
1.952 + information is a null descriptor.
1.953 + */
1.954 + KIMAP4MTMPopulateAllMailWhenAlreadyConnected,
1.955 +
1.956 + /** Connect to a specified service, populate the new messages in a specified
1.957 + folder, and stay connected.
1.958 +
1.959 + @c aSelection: @c aSelection[0] should contain the entry ID of the service;
1.960 + @c aSelection[1] should contain the entry ID of the folder containing
1.961 + the messages to populate.
1.962 +
1.963 + @c aParameter: A packaged TImImap4GetPartialMailInfo or TImImap4GetMailInfo
1.964 + specifying the message parts to fetch and size limits on what is fetched.
1.965 +
1.966 + Completion: note if there are no entries to populate, then KErrNone, and progress
1.967 + information is a null descriptor.
1.968 + */
1.969 + KIMAP4MTMConnectAndPopulateNewMailAndStayOnline,
1.970 +
1.971 + /** Connect to a specified service, populate the new messages in a specified
1.972 + folder, and disconnect afterwards.
1.973 +
1.974 + @c aSelection: @c aSelection[0] should contain the entry ID of the service;
1.975 + @c aSelection[1] should contain the entry ID of the folder containing
1.976 + the messages to populate.
1.977 +
1.978 + @c aParameter: A packaged TImImap4GetPartialMailInfo or TImImap4GetMailInfo
1.979 + specifying the message parts to fetch and size limits on what is fetched.
1.980 +
1.981 + Completion: note if there are no entries to populate, then KErrNone, and progress
1.982 + information is a null descriptor.
1.983 + */
1.984 + KIMAP4MTMConnectAndPopulateNewMailAndDisconnect,
1.985 +
1.986 + /** Connect to a specified service, populate all messages in a specified
1.987 + folder, and stay connected.
1.988 +
1.989 + @c aSelection: @c aSelection[0] should contain the entry ID of the service;
1.990 + @c aSelection[1] should contain the entry ID of the folder containing
1.991 + the messages to populate.
1.992 +
1.993 + @c aParameter: A packaged TImImap4GetPartialMailInfo or TImImap4GetMailInfo
1.994 + specifying the message parts to fetch and size limits on what is fetched.
1.995 +
1.996 + Completion: note if there are no entries to populate, then KErrNone, and progress
1.997 + information is a null descriptor.
1.998 + */
1.999 + KIMAP4MTMConnectAndPopulateAllMailAndStayOnline,
1.1000 +
1.1001 + /** Connect to a specified service, populate all messages in a specified
1.1002 + folder, and disconnect afterwards.
1.1003 +
1.1004 + @c aSelection: @c aSelection[0] should contain the entry ID of the service;
1.1005 + @c aSelection[1] should contain the entry ID of the folder containing
1.1006 + the messages to populate.
1.1007 +
1.1008 + @c aParameter: A packaged TImImap4GetPartialMailInfo or TImImap4GetMailInfo
1.1009 + specifying the message parts to fetch and size limits on what is fetched.
1.1010 +
1.1011 + Completion: note if there are no entries to populate, then KErrNone, and progress
1.1012 + information is a null descriptor.
1.1013 + */
1.1014 + KIMAP4MTMConnectAndPopulateAllMailAndDisconnect,
1.1015 +
1.1016 + /** Creates a new email message.
1.1017 +
1.1018 + @c aSelection: @c aSelection[0] should contain the entry ID of the folder in
1.1019 + which to create the message.
1.1020 +
1.1021 + @c aParameter: a packaged TImCreateMessageOptions (see miutmsg.h) object, specifying
1.1022 + message creation flags and message type.
1.1023 +
1.1024 + The operation object returned is a CImEmailOperation. Final progress information
1.1025 + from this contains the ID of the newly created message.
1.1026 + */
1.1027 + KIMAP4MTMCreateNewEmailMessage,
1.1028 +
1.1029 + /** Creates a new reply message.
1.1030 +
1.1031 + @c aSelection: @c aSelection[0] should contain the entry ID of the folder in
1.1032 + which to create the message; @c aSelection[1] should contain the entry ID
1.1033 + of the message to which to create a reply.
1.1034 +
1.1035 + @c aParameter: a packaged TImCreateMessageOptions (see miutmsg.h) object, specifying
1.1036 + message creation flags and message type.
1.1037 +
1.1038 + The operation object returned is a CImEmailOperation. Final progress information
1.1039 + from this contains the ID of the newly created message.
1.1040 + */
1.1041 + KIMAP4MTMCreateReplyEmailMessage,
1.1042 +
1.1043 + /** Creates a new forwarded message.
1.1044 +
1.1045 + @c aSelection: @c aSelection[0] should contain the entry ID of the folder in
1.1046 + which to create the message; @c aSelection[1] should contain the entry ID
1.1047 + of the message to forward.
1.1048 +
1.1049 + @c aParameter: a packaged TImCreateMessageOptions (see miutmsg.h) object, specifying
1.1050 + message creation flags and message type.
1.1051 +
1.1052 + The operation object returned is a CImEmailOperation. Final progress information
1.1053 + from this contains the ID of the newly created message.
1.1054 + */
1.1055 + KIMAP4MTMCreateForwardEmailMessage,
1.1056 +
1.1057 + /** Creates a new forwarded message, with the original message as an attachment.
1.1058 +
1.1059 + @c aSelection: @c aSelection[0] should contain the entry ID of the folder in
1.1060 + which to create the message; @c aSelection[1] should contain the entry ID
1.1061 + of the message to forward.
1.1062 +
1.1063 + @c aParameter: a packaged TImCreateMessageOptions (see miutmsg.h) object, specifying
1.1064 + message creation flags and message type.
1.1065 +
1.1066 + The operation object returned is a CImEmailOperation. Final progress information
1.1067 + from this contains the ID of the newly created message.
1.1068 + */
1.1069 + KIMAP4MTMCreateForwardAsAttachmentEmailMessage,
1.1070 +
1.1071 + /** Creates a new message-receipt message.
1.1072 +
1.1073 + @c aSelection: @c aSelection[0] should contain the entry ID of the folder in
1.1074 + which to create the message; @c aSelection[1] should contain the entry ID
1.1075 + of the original message for which the receipt is required.
1.1076 +
1.1077 + @c aParameter: a packaged TImCreateMessageOptions (see miutmsg.h) object, specifying
1.1078 + message creation flags and message type.
1.1079 +
1.1080 + The operation object returned is a CImEmailOperation. Final progress information
1.1081 + from this contains the ID of the newly created message.
1.1082 + */
1.1083 + KIMAP4MTMCreateReceiptEmailMessage
1.1084 +};
1.1085 +
1.1086 +#endif