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

  • Статья

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

Синтаксис

HRESULT AddItemMetadataToGroup(
  [in]      const BYTE         *pbOwnerReplicaId,
  [in]      const BYTE         *pbItemId,
  [in]      const SYNC_VERSION *pChangeVersion,
  [in]      const SYNC_VERSION *pCreationVersion,
  [in]      DWORD              dwFlags,
  [in]      DWORD              dwWorkForChange,
  [in, out] ISyncChangeBuilder **ppChangeBuilder
);

Параметры

[in] pbOwnerReplicaId

Идентификатор реплика реплика, где допустимы pChangeVersion и pCreationVersion. Формат идентификатора должен соответствовать формату, указанному в структуре ID_PARAMETERS поставщика.

[in] pbItemId

Идентификатор элемента. Формат идентификатора должен соответствовать формату, указанному в структуре ID_PARAMETERS поставщика.

[in] pChangeVersion

Версия этого изменения.

[in] pCreationVersion

Версия создания элемента.

[in] dwFlags

Флаги, указывающие состояние изменения элемента. Значения флагов см. в разделе ISyncChange::GetFlags.

[in] dwWorkForChange

Оценка трудоемких изменений. Это значение используется во время изменения приложения, чтобы сообщить о завершенной работе приложению.

[in, out] ppChangeBuilder

Возвращает объект , который можно использовать для добавления в изменение сведений об единицах изменения.

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
E_INVALIDARG
 DwFlags содержит недопустимое значение флага.
SYNC_E_INVALID_OPERATION
 Группа не открыта или пустая группа была ранее добавлена в пакет.
SYNC_E_RANGE_OUT_OF_ORDER
 Упорядоченная группа открыта, а значение pbItemId меньше идентификатора предыдущего элемента, добавленного в группу, или меньше идентификатора элемента, указанного при открытии группы.
SYNC_E_CHANGE_BATCH_IS_READ_ONLY
 Объект ISyncChangeBatchBase был отправлен в приложение изменений или в сеанс синхронизации.

Требования

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

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

Структура ID_PARAMETERS

Интерфейс ISyncChangeBatchBase

Структура SYNC_VERSION