2.2.3.2.4.2.1 RopSynchronizationImportMessageChange ROP Request Buffer

The following descriptions define valid fields for the request buffer of the RopSynchronizationImportMessageChange ROP ([MS-OXCROPS] section 2.2.13.2).

InputServerObject: The value of this field MUST be the synchronization upload context configured for the collection of changes to content.

ImportFlag (1 byte): An 8-bit flag structure that defines the parameters of the import operation.

The following table defines valid flags for the ImportFlag field.

Flag name

Value

Description

Associated

0x10

If this flag is set, the message being imported is an FAI message.

If this flag is not set, the message being imported is a normal message.

FailOnConflict

0x40

The server SHOULD<17> support this flag.

If this flag is set, the server accepts conflicting versions of a particular message.

If this flag is not set, the server does not accept conflicting versions of a particular message.

For more details, see section 3.2.5.9.4.2.

PropertyValueCount (2 bytes): An unsigned 16-bit integer. This value specifies the number of structures in the PropertyValues field. This value MUST NOT be set to 0x0000.

PropertyValues (variable): An array of TaggedPropertyValue structures ([MS-OXCDATA] section 2.11.4). These values are used to specify extra properties on the message; these are properties that cannot be set by using the RopSetProperties ROP.

The following table lists the restrictions that exist for properties passed in the PropertyValues field.

Property

Restrictions

Comments

PidTagSourceKey (section 2.2.1.2.5)

Required

Fixed position

A GID structure ([MS-OXCDATA] section 2.2.1.3) that identifies the message being uploaded in the local replica.

PidTagLastModificationTime ([MS-OXPROPS] section 2.765)

Required

Fixed position

None.

PidTagChangeKey (section 2.2.1.2.7)

Required

Fixed position

An XID structure, as specified in section 2.2.2.2, that identifies a change to a message being uploaded in a local replica. For details about how clients can generate this value, see section 3.1.5.3.

PidTagPredecessorChangeList (section 2.2.1.2.8)

Required

Fixed position

None.

< other properties >

Prohibited

None.