IAsynchronousNotifyingChangeApplierTarget::SaveChangeWithChangeUnits
Enregistre une modification d'élément qui contient des modifications d'unité de modification dans le magasin d'éléments.
Notes
Cette méthode est désormais obsolète.
Syntaxe
HRESULT SaveChangeWithChangeUnits(
ISyncChange * pChange,
ISaveChangeWithChangeUnitsContext * pSaveContext);
Paramètres
pChange
[in] Modification d'élément à appliquer.pSaveContext
[in] Informations relatives à la modification à appliquer.
Valeur de retour
S_OK
Codes d'erreur déterminés par le fournisseur
Remarques à l'attention des implémenteurs
Lorsque SaveChangeWithChangeUnits est appelé, le fournisseur doit entreprendre l'une des actions suivantes :
Retourner un code de réussite à partir de la méthode, puis appeler ultérieurement IAsynchronousNotifyingChangeApplierTargetCallback::SaveChangeWithChangeUnitsComplete pour signaler que le traitement asynchrone s'est terminé avec succès.
Retourner un code de réussite à partir de la méthode, puis appeler ultérieurement IAsynchronousNotifyingChangeApplierTargetCallback::OnError pour signaler qu'une erreur s'est produite lors du traitement asynchrone.
Retourner un code d'erreur à partir de la méthode. Dans ce cas, les méthodes IAsynchronousNotifyingChangeApplierTargetCallback ne doivent pas être appelées.
Lorsque l'action contenue dans pSaveContext est SSA_CREATE, toutes les unités de modification doivent être enregistrées avec succès ou l'intégralité de la modification d'élément doit être ignorée. Le fait d'enregistrer certaines unités de modification et de ne pouvoir enregistrer certaines autres peut provoquer un endommagement des données.
Lorsque ISaveChangeWithChangeUnitsContext::SetRecoverableErrorOnChangeUnit est appelé et pSaveContext est SSA_CREATE, SetRecoverableErrorOnChangeUnit retourne SYNC_E_ON_CREATE_MUST_FAIL_ENTIRE_ITEM.