4.4.2 Navigation Shortcut
Ryan creates a new shortcut to his folder "Meetings" and wants to group it under the new "My Work Calendars" group he created in the example in section 4.4.1.
The client sends a RopCreateMessage ROP request ([MS-OXCROPS] section 2.2.6.2) that has the FolderId set to the ID of the Common Views folder and the Associated flag set to 1 and then waits for the server to respond. The server response contains a handle to the Message object.
The client then sends a RopSetProperties ROP request ([MS-OXCROPS] section 2.2.8.6) to set the following properties. The property data types are all defined in ([MS-OXCDATA] section 2.11.1).
Property name |
PropertyID |
Property type |
Value |
---|---|---|---|
PidTagMessageClass ([MS-OXCMSG] section 2.2.1.3) |
0x001A |
0x001F (PtypString) |
"IPM.Microsoft.WunderBar.Link" |
PidTagNormalizedSubject (section 2.2.9.2) |
0x0E1D |
0x001F (PtypString) |
"Meetings" |
PidTagWlinkSaveStamp (section 2.2.9.4) |
0x6847 |
0x0003 (PtypInteger32) |
0x12345678 |
PidTagWlinkType (section 2.2.9.5) |
0x6849 |
0x0003 (PtypInteger32) |
0x00000000 |
PidTagWlinkFlags (section 2.2.9.6) |
0x684A |
0x0003 (PtypInteger32) |
0x00000000 |
PidTagWlinkOrdinal (section 2.2.9.7) |
0x684B |
0x0102 (PtypBinary) |
0x80 |
PidTagWlinkEntryId (section 2.2.9.8) |
0x684C |
0x0102 (PtypBinary) |
See explanation following this table |
PidTagWlinkRecordKey (section 2.2.9.9) |
0x684D |
0x0102 (PtypBinary) |
See explanation following this table |
PidTagWlinkStoreEntryId (section 2.2.9.10) |
0x684E |
0x0102 (PtypBinary) |
See explanation following this table |
PidTagWlinkFolderType (section 2.2.9.11) |
0x684F |
0x0048 (PtypGuid) |
0278060000000000 C000000000000046 |
PidTagWlinkGroupClsid (section 2.2.9.12) |
0x6850 |
0x0048 (PtypGuid) |
5BA943D8DAAA462C A63E9136F65C8681 |
PidTagWlinkGroupName (section 2.2.9.13) |
0x6851 |
0x001F (PtypString) |
"My Work Calendars" |
PidTagWlinkSection (section 2.2.9.14) |
0x6852 |
0x0003 (PtypInteger32) |
0x00000003 |
The values of the PidTagWlinkEntryId, PidTagWlinkRecordKey, and PidTagWlinkStoreEntryId properties are copied directly from the corresponding properties of the actual Calendar folder as described in section 2.2.9.8, section 2.2.9.9, and section 2.2.9.10.
The client then sends a RopSaveChangesMessage ROP request ([MS-OXCROPS] section 2.2.6.3) to persist the object on the server and a RopRelease ROP request ([MS-OXCROPS] section 2.2.15.3) to release the object.