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