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