ISyncChangeBatchBase::BeginOrderedGroup
Открывает упорядоченную группу в пакете изменений. Эта группа сортируется по идентификатору элемента.
HRESULT BeginOrderedGroup(
const BYTE * pbLowerBound);
Параметры
- pbLowerBound
[in] Закрытая нижняя граница идентификаторов элементов для этой упорядоченной группы. Чтобы задать нижнюю границу, равную 0, используйте NULL.
Возвращаемое значение
S_OK
SYNC_E_INVALID_OPERATION, если группа уже открыта или пустая группа была ранее добавлена в пакет.
SYNC_E_CHANGE_BATCH_IS_READ_ONLY, если объект ISyncChangeBatchBase был создан с использованием метода IProviderSyncServices::DeserializeChangeBatch или IProviderSyncServices::DeserializeFullEnumerationChangeBatch, а также если объект является объектом ISyncFullEnumerationChangeBatch, а группа уже добавлена в пакет.
SYNC_E_RANGE_OUT_OF_ORDER, если объект является объектом ISyncFullEnumerationChangeBatch, а pbLowerBound больше нижней границы идентификаторов, использованной при создании пакета.
Замечания
Изменения элементов, добавляемые к пакету изменений после вызова этого метода, добавляются в открытую группу. Изменения элементов, добавляемые к упорядоченной группе, должны добавляться в порядке возрастания идентификаторов элементов.
Изменения элементов нельзя добавить в пакет, пока не создана группа.