2.2.5.1 PersistData Structure

  • Article

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.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

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.