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