2.2.5.1.2.1 OP_MOVE and OP_COPY ActionData Structure
A Move/Copy action (2) is used to move or copy an incoming message to a specified folder in the destination message store. The ActionData structure used in an action (2) of type "OP_MOVE" or "OP_COPY" is one of two formats, depending on whether the rule is a standard rule or an extended rule.
Buffer Format for Standard Rules
The OP_MOVE and OP_COPY ActionData structure MUST be in the following format for a standard rule. The destination folder for a Move/Copy action in a standard rule can be in the user's mailbox or a different mailbox.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
FolderInThisStore |
StoreEIDSize |
StoreEID (variable) |
|||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
FolderEIDSize |
FolderEID (variable) |
||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
FolderInThisStore (1 byte): A Boolean value that indicates whether the folder is in the user's mailbox or a different mailbox. This field MUST be set to either a nonzero (TRUE) value, if the destination folder is in the user's mailbox, or to zero (FALSE), if the destination folder is outside the user's mailbox (for example, a local message store that the server cannot access).
StoreEIDSize (2 bytes): An integer that specifies the size, in bytes, of the StoreEID field.
StoreEID (variable): A Store Object EntryID structure, as specified in [MS-OXCDATA] section 2.2.4.3, that identifies the message store. This field is relevant only if the FolderInThisStore field is set to 0x00.
-
If the FolderInThisStore field is set to 0x01, the following applies to the StoreEID field for both the client and the server:
§ The StoreEID field can be set to any non-null value in request.
§ The contents of the StoreEID field MUST be ignored when received.
FolderEIDSize (2 bytes): An integer that specifies the size, in bytes, of the FolderEID field.
FolderEID (variable): A structure that identifies the destination folder. If the value of the FolderInThisStore field is 0x01, this field contains a ServerEid structure, as specified in section 2.2.5.1.2.1.1. If the value of the FolderInThisStore field is 0x00, the contents of this field can be any value that the client finds useful for locating the destination folder when the client processes a DAM that it receives from the server.
Buffer Format for Extended Rules
The OP_MOVE and OP_COPY ActionData structure MUST be in the following format for an extended rule. The destination folder for a Move/Copy action in an extended rule MUST be in the user's mailbox.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
StoreEIDSize |
|||||||||||||||||||||||||||||||
|
StoreEID (variable) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
FolderEIDSize |
|||||||||||||||||||||||||||||||
|
FolderEID (variable) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
StoreEIDSize (4 bytes): An integer that specifies the size, in bytes, of the StoreEID field.
StoreEID (variable): This field is not used and can be set to any non-null value by the client and the server. This field MUST be ignored when received by either the client or the server.
FolderEIDSize (4 bytes): An integer that specifies the size, in bytes, of the FolderEID field.
FolderEID (variable): A Folder EntryID structure, as specified in [MS-OXCDATA] section 2.2.4.1, that identifies the destination folder.