ISyncChangeBatchBase::BeginOrderedGroup
Opens an ordered group in the change batch. This group is ordered by item ID.
HRESULT BeginOrderedGroup(
const BYTE * pbLowerBound);
Parameters
- pbLowerBound
[in] The closed lower bound of item IDs for this ordered group. To specify a lower bound of 0, use NULL.
Return Value
S_OK
SYNC_E_INVALID_OPERATION when a group is already open or an empty group was previously added to the batch.
SYNC_E_CHANGE_BATCH_IS_READ_ONLY when the ISyncChangeBatchBase object was created by using IProviderSyncServices::DeserializeChangeBatch or IProviderSyncServices::DeserializeFullEnumerationChangeBatch, or when the object is an ISyncFullEnumerationChangeBatch object and a group has already been added to the batch.
SYNC_E_RANGE_OUT_OF_ORDER when the object is an ISyncFullEnumerationChangeBatch object and pbLowerBound is greater than the lower bound ID that was used to create the batch.
Remarks
Item changes that are added to the change batch after this method is called are added to the open group. Item changes that are added to an ordered group must be added in increasing order by item ID.
Item changes cannot be added to the change batch until a group is opened.