2.2.3.2.4.3.1 RopSynchronizationImportHierarchyChange ROP Request Buffer
The following descriptions define valid fields for the request buffer of the RopSynchronizationImportHierarchyChange ROP ([MS-OXCROPS] section 2.2.13.4).
InputServerObject: The value of this field MUST be the synchronization upload context configured to collect changes to the hierarchy.
HierarchyValueCount (2 bytes): An unsigned 16-bit integer. This value specifies the number of structures in the HierarchyValues field. This value MUST NOT be set to 0x0000.
HierarchyValues (variable): An array of TaggedPropertyValue structures ([MS-OXCDATA] section 2.11.4). These values are used to specify folder hierarchy properties, which determine the location of the folder within the hierarchy. The following table lists the restrictions that exist on the array of values of the HierarchyValues field.
|
Property |
Restrictions |
Comments |
|---|---|---|
|
PidTagParentSourceKey (section 2.2.1.2.6) |
Required Fixed position |
SHOULD<18> be zero-length to identify a folder for which a synchronization upload context was opened. |
|
PidTagSourceKey (section 2.2.1.2.5) |
Required Fixed position |
A GID structure ([MS-OXCDATA] section 2.2.1.3) that identifies the folder 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 the change being uploaded in the local replica. For details about how clients can generate the PidTagChangeKey value, see section 3.1.5.3. |
|
PidTagPredecessorChangeList (section 2.2.1.2.8) |
Required Fixed position |
None. |
|
PidTagDisplayName ([MS-OXCFOLD] section 2.2.2.2.2.5) |
Required Fixed position |
This value MUST be a nonempty string. |
|
< other properties > |
Prohibited |
None. |
PropertyValueCount (2 bytes): An unsigned 16-bit integer. This value specifies the number of structures in the PropertyValues field. The value of this field MUST NOT be set to 0x0000.
PropertyValues (variable): An array of TaggedPropertyValue structures ([MS-OXCDATA] section 2.11.1) that contains the changed folder properties.