ISimpleSyncProvider::UpdateItem
Chamado pelo tempo de execução do Sync Framework para atualizar um item no repositório de destino.
HRESULT UpdateItem(
IUnknown *pItemData,
const CHANGE_UNIT_SET *pChangeUnitsToUpdate,
const ITEM_FIELDS *pKeyAndExpectedVersionInfo,
IRecoverableErrorCallback *pRecoverableErrorCallback,
ITEM_FIELDS **ppUpdatedKeyAndVersionInfo,
BOOL *pfCommitKnowledgeAfterThisItem);
Parâmetros
- pItemData
[in] Os dados do item no formato específico do provedor.
- pChangeUnitsToUpdate
[in, unique] Um objeto CHANGE_UNIT_SET que contém as unidades de alteração a serem atualizadas para um item. Se nenhuma unidade de alteração for especificada, o parâmetro deverá ser null (não vazio).
pKeyAndExpectedVersionInfo
[in] As propriedades de chave e versão esperada do item a ser atualizado.O provedor deve executar uma verificação de simultaneidade otimista para se certificar de que a versão do item no destino corresponde aos valores encontrados em pKeyAndExpectedVersionInfo. Se essa verificação falhar, o provedor deverá relatar um erro recuperável.
- pRecoverableErrorCallback
[in] Um objeto IRecoverableErrorCallback com métodos que poderão ser chamados se ocorrer um erro recuperável durante a atualização de um item.
- ppUpdatedKeyAndVersionInfo
[out] Retorna as propriedades de chave e versão atualizada dos itens atualizados. Se o valor de retorno não for válido, o tempo de execução do Sync Framework encerrará a sessão.
- pfCommitKnowledgeAfterThisItem
[out] Retorna se o tempo de execução do Sync Framework deve confirmar o conhecimento para o repositório de metadados após a conclusão do processamento para o item especificado.
Valor de retorno
- S_OK