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 RopOpenMessage ROP 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.