IAsynchronousNotifyingChangeApplierTarget::SaveChangeWithChangeUnits

Salva una modifica dell'elemento che contiene modifiche dell'unità di modifica all'archivio di elementi.

Nota

Questo metodo è obsoleto.

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

Parametri

• pChange
  [in] Modifica dell'elemento da applicare.

• pSaveContext
  [in] Informazioni sulla modifica da applicare.

Valore restituito

• S_OK

• Codici di errore determinati dal provider

Note per gli implementatori

Quando viene chiamato SaveChangeWithChangeUnits, il provider deve eseguire una delle azioni seguenti:

• Restituire un codice di esito positivo dal metodo e successivamente chiamare IAsynchronousNotifyingChangeApplierTargetCallback::SaveChangeWithChangeUnitsComplete per segnalare che l'elaborazione asincrona è stata completata correttamente.

• Restituire un codice di esito positivo dal metodo e successivamente chiamare IAsynchronousNotifyingChangeApplierTargetCallback::OnError per segnalare che durante l'elaborazione asincrona si è verificato un errore.

• Restituire un codice di errore dal metodo. In questo caso, i metodi IAsynchronousNotifyingChangeApplierTargetCallback non devono essere chiamati.

Quando l'azione contenuta in pSaveContext è SSA_CREATE, tutte le unità di modifica devono essere salvate correttamente oppure l'intera modifica dell'elemento deve essere rimossa. Un salvataggio corretto per alcune delle unità di modifica e con esito negativo per altre può comportare il danneggiamento dei dati.

Quando viene chiamato ISaveChangeWithChangeUnitsContext::SetRecoverableErrorOnChangeUnit e pSaveContext è SSA_CREATE, SetRecoverableErrorOnChangeUnit restituisce SYNC_E_ON_CREATE_MUST_FAIL_ENTIRE_ITEM.

Vedere anche

Riferimento

Interfaccia IAsynchronousNotifyingChangeApplierTarget
Interfaccia IAsynchronousNotifyingChangeApplierTargetCallback