IExchangeImportContentsChanges::ImportMessageMove

The ImportMessageMove method transfers a message from one folder to another.

HRESULT ImportMessageMove(
  ULONG cbSourceKeySrcFolder,       
  BYTE FAR * pbSourceKeySrcFolder,  
  ULONG cbSourceKeySrcMessage,      
  BYTE FAR * pbSourceKeySrcMessage,  
  ULONG cbPCLMessage,               
  BYTE FAR * pbPCLMessage,          
  ULONG cbSourceKeyDestMessage,     
  BYTE FAR * pbSourceKeyDestMessage,  
  ULONG cbChangeNumDestMessage,     
  BYTE FAR * pbChangeNumDestMessage   
);
 

Parameters

cbSourceKeySrcFolder

Input parameter. The length, in bytes, of the key contained in pbSourceKeySrcFolder.

pbSourceKeySrcFolder

Input parameter. Points to a key of type PR_SOURCE_KEY that identifies the parent folder for this message.

cbSourceKeySrcMessage

Input parameter. The length, in bytes, of the key contained in pbSourceKeySrcMessage.

pbSourceKeySrcMessage

Input parameter. Points to a key of type PR_SOURCE_KEY that identifies this message.

cbPCLMessage

Input parameter. The length, in bytes, of the key contained in pbPCLMessage.

pbPCLMessage

Input parameter. Points to a key of type PR_PREDECESSOR_CHANGE_LIST that contains the change list for this message.

cbSourceKeyDestMessage

Input parameter. The length, in bytes, of the key contained in pbSourceKeyDestMessage.

pbSourceKeyDestMessage

Input parameter. Points to a key of type PR_SOURCE_KEY that identifies this message after the change.

cbChangeNumDestMessage

Input parameter. The length, in bytes, of the key contained in pbChangeNumDestMessage.

pbChangeNumDestMessage

Input parameter. Points to a key of type PR_CHANGE_KEY that identifies this change.

Return Values

See Return Values.

In addition, ImportMessageMove can return one of the following values:

SUCCESS_SUCCESS

The method completed successfully.

SYNC_E_INVALID_PARAMETER

One of the parameters was not valid.

Remarks

The ImportMessageMove method is used by the collector to move a message, instead of having to delete the message and recreate it under a different parent.

See Also

IExchangeImportContentsChanges, IExchangeImportHierarchyChanges::ImportFolderChange