2.2.4.3.19 progressTotal Element

The progressTotal element contains data that describes the approximate size of all the messageChange elements, as specified in section 2.2.4.3.11, that will follow in this stream. This element can be used by clients to display progress information. Servers can use a sum of message sizes (PidTagMessageSize property (section 2.2.1.6)) for all message changes downloaded in the current operation, or servers can use a different approximation.

Note that this method of reporting progress is provided in addition to what is available in the RopFastTransferSourceGetBuffer ROP response, as specified in section 2.2.3.1.1.5. This method of reporting is supposed to reflect the amount of work more precisely, as it is based on message sizes, rather than object count.

This element MUST be present if the Progress flag of the SynchronizationFlags field, as specified in section 2.2.3.2.1.1.1, was set when configuring the synchronization download operation and a server supports progress reporting.

This element MUST NOT be present if the Progress flag of the SynchronizationFlags field was not set when configuring the synchronization download operation.

The following table lists the restrictions that exist on the contained propList element, as specified in section 2.2.4.3.20.

Property type name

Restrictions

Comments

[PtypBinary] ([MS-OXCDATA] section 2.11.1)

0x00000102

Required

Fixed position

Serialized ProgressInformation structure. For more details, see section 2.2.2.7.

< other properties >

Prohibited

None.