ISyncChangeBatchBase::AddItemMetadataToGroup

  • Статья

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

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

Параметры

  • pbOwnerReplicaId
    [in] Идентификатор реплики, для которой допустимы значения параметров pChangeVersion и pCreationVersion. Идентификатор формата должен соответствовать формату, определяемому структурой ID_PARAMETERS поставщика.
  • pbItemId
    [in] Идентификатор элемента. Идентификатор формата должен соответствовать формату, определяемому структурой ID_PARAMETERS поставщика.
  • pChangeVersion
    [in] Версия этого изменения.
  • pCreationVersion
    [in] Версия создания элемента.
  • dwFlags
    [in] Флаги, определяющие состояние изменения элемента. Значения флагов см. в разделе Флаги SYNC_CHANGE_FLAG.
  • dwWorkForChange
    [in] Оцениваемый объем работы для изменения. Это значение используется во время применения изменений, чтобы сообщить приложению о завершении работы.
  • ppChangeBuilder
    [in, out, unique] Возвращает объект, который можно использовать для добавления сведений о базовых единицах в изменение.

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

  • S_OK

  • E_INVALIDARG, если dwFlags содержит недопустимое значение флага.

  • SYNC_E_INVALID_OPERATION, если нет открытых групп, либо ранее в пакет была добавлена пустая группа.

  • SYNC_E_RANGE_OUT_OF_ORDER, если упорядоченная группа открыта и значение pbItemId меньше идентификатора предыдущего элемента, добавленного в группу, либо меньше идентификатора элемента, указанного при открытии группы.

  • SYNC_E_CHANGE_BATCH_IS_READ_ONLY, если объект ISyncChangeBatchBase был передан в объект применения изменений или в сеанс синхронизации, а также если объект был создан с помощью метода IProviderSyncServices::DeserializeChangeBatch или IProviderSyncServices::DeserializeFullEnumerationChangeBatch.

См. также

Справочник

Интерфейс ISyncChangeBatchBase
Структура SYNC_VERSION

Основные положения

Отчет о ходе синхронизации