Export (0) Print
Expand All

4.1 Color-Flagged Object

Ryan Gregg has a message in his Inbox related to the Woodgrove Bank account, which he has associated to the orange flag. He uses the default request string designated by the client, which is "Follow up". The following is a description of what a client might do to accomplish Ryan's intentions and the responses a server might return.

To open the message to be flagged, the client sends a RopOpenMessageROP request ([MS-OXCROPS] section 2.2.6.1) and waits for the server to respond. The server response contains a handle to the Message object.

To retrieve some properties of the Message object, the client sends a RopGetPropertiesSpecific ROP request ([MS-OXCROPS] section 2.2.8.3).

Property

Property ID

Property type

PidTagMessageDeliveryTime ([MS-OXOMSG] section 2.2.3.9)

0x0E06

0x0040 (PtypTime ([MS-OXCDATA] section 2.11.1))

The client receives a ROP response buffer from the server with the requested property values.

Property

Property ID

Property type

Value

PidTagMessageDeliveryTime

0x0E06

0x0040

2008/02/11 22:41:24.765

To set the properties for the color flag, the client sends a RopSetProperties ROP request ([MS-OXCROPS] section 2.2.8.6) with the values that are specified in the following table.

Property

Property ID

Property type

Value

PidTagFlagStatus (section 2.2.1.1)

0x1090

0x0003 (PtypInteger32 ([MS-OXCDATA] section 2.11.1))

0x00000002

PidTagFollowupIcon (section 2.2.1.2)

0x1095

0x0003

0x00000002

PidTagReplyRequested (section 2.2.1.4)

0x0C17

0x000B (PtypBoolean ([MS-OXCDATA] section 2.11.1))

0x01 (TRUE)

PidTagResponseRequested (section 2.2.1.5)

0x0063

0x000B

0x01 (TRUE)

PidLidFlagRequest (section 2.2.1.9)

0x802A

0x001F (PtypString ([MS-OXCDATA] section 2.11.1))

"Follow up"

PidLidFlagString (section 2.2.1.10)

0x83C0

0x0003

0x00000003

PidLidValidFlagStringProof (section 2.2.1.11)

0x83CA

0x0040

2008/02/11 22:41:24.765

Finally, to persist the Message object on the server, the client sends a RopSaveChangesMessage ROP request ([MS-OXCROPS] section 2.2.6.3), followed by a RopRelease ROP request ([MS-OXCROPS] section 2.2.15.3) to release the object.

The above properties are all that is strictly necessary to flag an object with a color flag. Clients can set the other properties discussed in section 2.2.1.7 to appropriate values, if desired.

Show:
© 2014 Microsoft