ISimpleSyncProvider::UpdateItem
Appelé par Sync Framework Runtime pour mettre à jour un élément dans le magasin de destination.
HRESULT UpdateItem(
IUnknown *pItemData,
const CHANGE_UNIT_SET *pChangeUnitsToUpdate,
const ITEM_FIELDS *pKeyAndExpectedVersionInfo,
IRecoverableErrorCallback *pRecoverableErrorCallback,
ITEM_FIELDS **ppUpdatedKeyAndVersionInfo,
BOOL *pfCommitKnowledgeAfterThisItem);
Paramètres
- pItemData
[in] Données de l'élément dans un format spécifique au fournisseur.
- pChangeUnitsToUpdate
[in, unique] Objet CHANGE_UNIT_SET qui contient les unités de modification à mettre à jour pour un élément. Le paramètre doit être Null (non vide) si aucune unité de modification n'est spécifiée.
pKeyAndExpectedVersionInfo
[in] Clé et propriétés de version attendues de l'élément à mettre à jour.Le fournisseur doit effectuer un contrôle d'accès concurrentiel optimiste pour vérifier que la version de l'élément sur la destination correspond aux valeurs disponibles dans pKeyAndExpectedVersionInfo. Si ce contrôle échoue, le fournisseur doit signaler une erreur récupérable.
- pRecoverableErrorCallback
[in] Objet IRecoverableErrorCallback qui contient des méthodes qui peuvent être appelées si une erreur récupérable se produit pendant une mise à jour d'élément.
- ppUpdatedKeyAndVersionInfo
[out] Retourne la clé et les propriétés de version mises à jour des éléments mis à jour. Si la valeur retournée n'est pas valide, Sync Framework Runtime termine la session.
- pfCommitKnowledgeAfterThisItem
[out] Indique si Sync Framework Runtime doit valider la connaissance au magasin des métadonnées une fois le traitement terminé pour l'élément spécifié.
Valeur de retour
- S_OK