2.2.1.7 PidTagSwappedToDoData Property

Type: PtypBinary ([MS-OXCDATA] section 2.11.1)

The PidTagSwappedToDoData property ([MS-OXPROPS] section 2.1038) acts as the secondary flag storage location if sender flags or sender reminders are supported.<7> This secondary storage location can be used by the client to maintain a second set of the flagging-related property values that do not affect the flag state of the Message object.

Properties for a sender flag or a sender reminder can be stored in the PidTagSwappedToDoData property without exposing the sender flag or sender reminder information to the recipients of the message. Similarly, properties for a recipient flag or a recipient reminder can be stored in the PidTagSwappedToDoData property for informational purposes on a previously sent message. For details about reminders, see [MS-OXORMDR].

The PidTagSwappedToDoData property contains the following fields. The mapping of these fields to the primary flag storage location is specified in each field description.

ulVersion (4 bytes):  An integer that specifies the version of the PidTagSwappedToDoData property. This protocol specifies only version 0x00000001. The contents of the PidTagSwappedToDoData property MUST be ignored if the version number is not 0x00000001.

dwFlags (4 bytes):  A set of bits that indicate the validity of the six member fields that correspond to properties. The bits specified in the following table are combined by using a bitwise OR operation.

dwToDoItem (4 bytes):  An integer that corresponds to the PidTagToDoItemFlags property (section 2.2.1.6).

wszFlagTo (512 bytes):  A string of Unicode characters that corresponds to the PidLidFlagRequest property (section 2.2.1.9).

rtmStartDate (4 bytes):  An integer that corresponds to the PidLidTaskStartDate property ([MS-OXOTASK] section 2.2.2.2.4).

rtmDueDate (4 bytes):  An integer that corresponds to the PidLidTaskDueDate property ([MS-OXOTASK] section 2.2.2.2.5).

rtmReminder (4 bytes):  An integer that corresponds to the PidLidReminderTime ([MS-OXORMDR] section 2.2.1.4), PidLidReminderSignalTime ([MS-OXORMDR] section 2.2.1.2), and PidTagReplyTime (section 2.2.3.1) properties.

When the contents of the primary flag storage location and secondary flag storage location are swapped, the contents of the rtmReminder field are written to the PidLidReminderTime, PidLidReminderSignalTime, and PidTagReplyTime properties, and the data in the PidLidReminderTime property is written to the rtmReminder field. For details about reminder properties, see [MS-OXORMDR] section 2.2.1.

fReminderSet (4 bytes):  A Boolean value that corresponds to the PidLidReminderSet property ([MS-OXORMDR] section 2.2.1.1).

The value in the rtmStartDate, rtmDueDate, and rtmReminder fields is stored as a 4-byte integer that is expressed as the number of minutes since 00:00:00 on January 1, 1601, in UTC. To indicate no date and time, the rtmStartDate, rtmDueDate, and rtmReminder fields are set to the value 0x5AE980E0.