IAsynchronousNotifyingChangeApplierTarget::SaveChangeWithChangeUnits

Artikel
11/02/2009

Speichert eine Elementänderung, die Änderungen der Änderungseinheit enthält, im Elementspeicher.

Hinweis

Diese Methode ist mittlerweile veraltet.

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

Parameter

pChange
[in] Die anzuwendende Elementänderung.

pSaveContext
[in] Informationen über die anzuwendende Änderung.

Rückgabewert

S_OK
Anbieterspezifische Fehlercodes.

Hinweise für Implementierer

Wenn SaveChangeWithChangeUnits aufgerufen wird, muss der Anbieter eine der folgenden Aktionen ausführen:

Einen Erfolgscode von der Methode zurückgeben und später IAsynchronousNotifyingChangeApplierTargetCallback::SaveChangeWithChangeUnitsComplete aufrufen, um die erfolgreiche Beendigung der asynchronen Verarbeitung zu melden.
Einen Erfolgscode von der Methode zurückgeben und später IAsynchronousNotifyingChangeApplierTargetCallback::OnError aufrufen, um zu melden, dass während der asynchronen Verarbeitung ein Fehler aufgetreten ist.
Einen Fehlercode von der Methode zurückgeben. In diesem Fall sollten keine IAsynchronousNotifyingChangeApplierTargetCallback-Methoden aufgerufen werden.

Wenn die in pSaveContext enthaltene Aktion SSA_CREATE ist, müssen entweder alle Änderungseinheiten erfolgreich gespeichert werden oder die gesamte Elementänderung muss verworfen werden. Wenn einige Änderungseinheiten gespeichert werden und andere nicht gespeichert werden können, kann dies zur Beschädigung von Daten führen.

Wenn ISaveChangeWithChangeUnitsContext::SetRecoverableErrorOnChangeUnit aufgerufen wird und pSaveContext SSA_CREATE ist, gibt SetRecoverableErrorOnChangeUnit SYNC_E_ON_CREATE_MUST_FAIL_ENTIRE_ITEM zurück.

Siehe auch

Verweis

IAsynchronousNotifyingChangeApplierTarget-Schnittstelle
IAsynchronousNotifyingChangeApplierTargetCallback-Schnittstelle

Freigeben über