3.1.4.8 Performing a Conversation Action

The following user actions performed on a conversation SHOULD<37> modify the conversation actions, as specified in section 2.2.8, on a conversation and trigger special handling logic:

• Ignore

• Stop Ignoring

• Move to Folder

• Stop Move

• Add Category

• Remove Category

• Clear All Categories

When the user performs one of these actions on a conversation, the client SHOULD identify all unique values of the PidTagConversationId property ([MS-OXOMSG] section 2.2.1.2) on the E-mail objects and do the following for each conversation ID:

1. The client SHOULD locate the conversation action FAI message in the Conversation Actions Settings special folder with bytes 6-21 of the PidTagConversationIndex property (section 2.2.8.8) corresponding to the given conversation ID. If no such FAI message exists, proceed to step 4.

2. If the user is performing a Stop Ignoring action and the FAI message does not indicate that there is an Ignore conversation action (as specified in sections 2.2.8.3 and 2.2.8.4), the client SHOULD NOT perform the Stop Ignoring action for this conversation ID.

3. If the user is performing a Stop Move action and the FAI message does not indicate that there is a Move to Folder conversation action (as specified in sections 2.2.8.3 and 2.2.8.4), the client SHOULD NOT perform the Stop Move action for this conversation ID.

4. If no existing FAI message is found, a new FAI message SHOULD be created with the properties specified in section 2.2.8.

5. The client SHOULD<38> locate all E-mail objects on the message store with a PidTagConversationId property value matching the given conversation ID. If the operation cannot be done in a timely fashion, the client can proceed as though no E-mail objects were found.

6. The client SHOULD perform the appropriate action on all located E-mail objects, as specified in the second column of the table following this procedure.

7. The client SHOULD set the latest value of the PidTagMessageDeliveryTime property ([MS-OXOMSG] section 2.2.3.9) from the located E-mail objects as the PidLidConversationActionMaxDeliveryTime property (section 2.2.8.2) on the FAI message. If no messages were found, the PidLidConversationActionMaxDeliveryTime property SHOULD be set to 00:00:00 (UTC) April 1, 1601.

8. The client SHOULD set the current time (in UTC) as the PidLidConversationActionLastAppliedTime property (section 2.2.8.1) on the FAI message.

9. The client SHOULD perform the appropriate action on the FAI message, as specified in the third column of the table following this procedure.

10. If the server returned a version less than 14.0.324.0, as described in section 1.7, and the PidLidConversationActionMoveFolderEid (section 2.2.8.3) and PidNameKeywords (section 2.2.8.7) properties are both not set, the client SHOULD delete the FAI message.

Appropriate actions for the client to perform for each user action are specified in the following table.