Поделиться через

Метод ISyncChangeBatchBase::BeginOrderedGroup (winsync.h)

  • Статья

Открывает упорядоченную группу в пакете изменений. Эта группа упорядочена по идентификатору элемента.

Синтаксис

HRESULT BeginOrderedGroup(
  [in] const BYTE *pbLowerBound
);

Параметры

[in] pbLowerBound

Закрытая нижняя граница идентификаторов элементов для этой упорядоченной группы. Чтобы указать нижнюю границу нуля, используйте значение NULL.

Возвращаемое значение

Возможные коды возврата включают, но не ограничиваются ими, значения, показанные в следующей таблице.

Код возврата Описание
S_OK
 Метод выполнен успешно.
SYNC_E_INVALID_OPERATION
 Группа уже открыта или пустая группа была ранее добавлена в пакет.
SYNC_E_CHANGE_BATCH_IS_READ_ONLY
 Объект является объектом ISyncFullEnumerationChangeBatch , и группа уже добавлена в пакет.
SYNC_E_RANGE_OUT_OF_ORDER
 Объект является объектом ISyncFullEnumerationChangeBatch , а pbLowerBound больше идентификатора нижней границы, который использовался для создания пакета.

Комментарии

Изменения элементов, которые добавляются в пакет изменений после вызова этого метода, добавляются в открытую группу. Изменения элементов, добавляемые в упорядоченную группу, должны добавляться в порядке увеличения по идентификатору элемента.

Изменения элементов нельзя добавить в пакет изменений, пока не откроется группа.

Требования

   
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header winsync.h

См. также раздел

Интерфейс ISyncChangeBatchBase