IAsynchronousNotifyingChangeApplierTarget::SaveChangeWithChangeUnits

Artigo
10/17/2009

Salva uma alteração de item que contém alterações da unidade de alteração no repositório de itens.

Dica

Esse método agora está obsoleto.

HRESULT SaveChangeWithChangeUnits(
  ISyncChange * pChange,
  ISaveChangeWithChangeUnitsContext * pSaveContext);

Parâmetros

pChange
[in] A alteração de item a ser aplicada.

pSaveContext
[in] Informações sobre a alteração a ser aplicada.

Valor de retorno

S_OK
Códigos de erro determinados pelo provedor

Observações para implementadores

Quando SaveChangeWithChangeUnits é chamado, o provedor deve executar uma destas ações:

Retornar um código de êxito do método e, posteriormente, chamar IAsynchronousNotifyingChangeApplierTargetCallback::SaveChangeWithChangeUnitsComplete para relatar que o processamento assíncrono foi concluído com êxito.
Retornar um código de erro do método e, posteriormente, chamar IAsynchronousNotifyingChangeApplierTargetCallback::OnError para relatar que ocorreu um erro durante o processamento assíncrono.
Retornar um código de erro do método. Nesse caso, os métodos IAsynchronousNotifyingChangeApplierTargetCallback não devem ser chamados.

Quando a ação contida em pSaveContext for SSA_CREATE, todas as unidades de alteração devem ser salvas com êxito ou a alteração de item inteira deve ser descartada. Salvar algumas unidades de alteração e não salvar outras pode corromper os dados.

Quando ISaveChangeWithChangeUnitsContext::SetRecoverableErrorOnChangeUnit é chamado e pSaveContext é SSA_CREATE, SetRecoverableErrorOnChangeUnit retorna SYNC_E_ON_CREATE_MUST_FAIL_ENTIRE_ITEM.

Consulte também

Referência

Interface IAsynchronousNotifyingChangeApplierTarget
Interface IAsynchronousNotifyingChangeApplierTargetCallback

Compartilhar via