IChangeApplicationServices::GetChangeApplicationContext
Obtient un objet qui représente la modification actuelle à appliquer.
Syntaxe
HRESULT GetChangeApplicationContext(
ISyncChange * pSourceChange,
ISyncChange * pDestinationVersion,
IChangeApplicationContext ** ppContext);
Paramètres
pSourceChange
[in, unique] Modification reçue du fournisseur de source. Peut avoir la valeur NULL lorsque le lot de modifications fait partie d'une synchronisation de récupération.pDestinationVersion
[in, unique] Version de pSourceChange dans le réplica de destination. Peut avoir la valeur NULL lorsque le réplica de destination n'a pas de version pour pSourceChange.ppContext
[out] Retourne un objet qui peut être utilisé pour traiter la modification.
Valeur de retour
S_OK.
E_OUTOFMEMORY.
E_POINTER.
SYNC_E_ACTIVE_CHANGE_APPLICATION_CONTEXT lorsqu'un objet IChangeApplicationContext est déjà actif. L'objet IChangeApplicationContext actif doit être traité jusqu'à ce que sa méthode IChangeApplicationContext::GetChangeApplicationAction retourne CAA_FINISHED avant qu'une autre modification puisse être traitée.
SYNC_E_CHANGE_NEEDS_KNOWLEDGE lorsque pSourceChange ne contient pas de connaissance courante.
SYNC_E_CHANGE_NOT_IN_KNOWLEDGE lorsque la version de mise à jour ou la version de création de pSourceChange n'est pas contenue dans sa connaissance courante.
SYNC_E_CHANGE_UNIT_COUNT_MISMATCH lorsque pSourceChange et pDestinationVersion contiennent différer nombres d'unités de modification.
SYNC_E_ID_FORMAT_MISMATCH lorsque le format d'un ID spécifié ne correspond pas au schéma du format d'ID spécifié lors de l'initialisation de cet objet.
SYNC_E_INVALID_OPERATION lorsque l'application des modifications n'a pas été démarrée pour un lot de modifications, ou lorsque pSourceChange a déjà été signalé comme ayant été appliqué avec succès.
SYNC_E_ITEM_HAS_CHANGE_UNITS lorsque pSourceChange ou pDestinationVersion contient des unités de modification et que l'autre n'en contient pas.
SYNC_E_NOT_EXPECTED_CHANGE lorsque pSourceChange et pDestinationVersion font référence à des ID d'élément différents.
Notes
Cette méthode est généralement appelée par le fournisseur de destination une fois pour chaque modification envoyée à partir du fournisseur de source. L'objet IChangeApplicationContext retourné peut être utilisé pour effectuer une détection de conflit et une résolution de conflit, et pour déterminer la façon dont le fournisseur de destination doit appliquer la modification spécifiée par pSourceChange.