2.2.5.1 PersistData Structure
The PersistData structure contains the entry ID of a special folder and other data related to a special folder. The PersistData structure has the following format.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
PersistID |
DataElementsSize |
||||||||||||||||||||||||||||||
|
DataElements (variable) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
PersistID (2 bytes): An integer that identifies the type of special folder to which the PersistData structure pertains.
-
The value of the PersistID field SHOULD<2> be one of those listed in the following table. If a PersistData structure is encountered where the value of the PersistID field is not known to the implementation, the implementation MUST ignore that PersistData structure.
|
Value name |
Value |
Meaning |
|---|---|---|
|
RSF_PID_RSS_SUBSCRIPTION |
0x8001 |
Indicates that the structure contains data for the RSS Feeds folder. |
|
RSF_PID_SEND_AND_TRACK |
0x8002 |
Indicates that the structure contains data for the Tracked Mail Processing folder. |
|
RSF_PID_TODO_SEARCH |
0x8004 |
Indicates that the structure contains data for the To-Do folder. |
|
RSF_PID_CONV_ACTIONS |
0x8006 |
Indicates that the structure contains data for the Conversation Action Settings folder. |
|
RSF_PID_COMBINED_ACTIONS |
0x8007 |
This value is reserved. |
|
RSF_PID_SUGGESTED_CONTACTS |
0x8008 |
Indicates that the structure contains data for the Suggested Contacts folder. |
|
RSF_PID_CONTACT_SEARCH |
0x8009 |
Indicates that the structure contains data for the Contacts Search folder. |
|
RSF_PID_BUDDYLIST_PDLS |
0x800A |
Indicates that the structure contains data for the IM Contacts List folder. |
|
RSF_PID_BUDDYLIST_CONTACTS |
0x800B |
Indicates that the structure contains data for the Quick Contacts folder. |
|
PERSIST_SENTINEL |
0x0000 |
Indicates that the PersistData structure is the last one contained in the PidTagAdditionalRenEntryIdsEx property (section 2.2.5). The PERSIST_SENTINEL is optional; if it is not included, processing continues to the end of the data stream. |
DataElementsSize (2 bytes): The size, in bytes, of the DataElements field.
DataElements (variable): An array of PersistElement structures (section 2.2.5.2), each of which contains the data about the special folder. The last PersistElement structure in the array is indicated either by the ELEMENT_SENTINEL value in the ElementID field of the PersistElement structure or by the end of the data stream.