ISimpleSyncProvider::UpdateItem
Вызывается средой выполнения Sync Framework, чтобы обновить элемент в хранилище назначения.
HRESULT UpdateItem(
IUnknown *pItemData,
const CHANGE_UNIT_SET *pChangeUnitsToUpdate,
const ITEM_FIELDS *pKeyAndExpectedVersionInfo,
IRecoverableErrorCallback *pRecoverableErrorCallback,
ITEM_FIELDS **ppUpdatedKeyAndVersionInfo,
BOOL *pfCommitKnowledgeAfterThisItem);
Параметры
- pItemData
[in] Данные для элемента в собственном формате поставщика.
- pChangeUnitsToUpdate
[in, unique] Объект CHANGE_UNIT_SET, содержащий базовые единицы, обновляемые для элемента. Если базовая единица указана, то параметр должен быть равен null (не пусто).
pKeyAndExpectedVersionInfo
[in] Свойства ключа и ожидаемой версии обновляемого элемента.Поставщик должен выполнить проверку оптимистичного параллелизма, чтобы проверить, что версия элемента в назначении соответствует значениям, найденным в параметре pKeyAndExpectedVersionInfo. Если проверка завершилась неуспешно, то поставщик должен сообщить об устранимой ошибке.
- pRecoverableErrorCallback
[in] Объект IRecoverableErrorCallback, содержащий методы, которые можно вызывать, если в ходе обновления элемента происходит устранимая ошибка.
- ppUpdatedKeyAndVersionInfo
[out] Возвращает обновленные свойства ключа и версии для обновленных элементов. Если возвращаемое значение недопустимо, то среда выполнения Sync Framework завершает сеанс.
- pfCommitKnowledgeAfterThisItem
[out] Возвращает значение, которое указывает, должна ли среда выполнения Sync Framework зафиксировать знания в хранилище метаданных после завершения обработки указанного элемента.
Возвращаемое значение
- S_OK