Interface IChangeApplicationServices
Représente un objet de service d'application de modifications qui peut être utilisé pour effectuer individuellement des actions d'application de modifications.
Syntaxe
interface IChangeApplicationServices : IUnknown
Membres
Méthode IChangeApplicationServices |
Description |
|---|---|
Initialise l'objet de service d'application de modifications. Cette méthode doit être appelée avant toute autre méthode. |
|
Commence le traitement d'un ensemble de modifications. |
|
IChangeApplicationServices::BeginFullEnumerationChangeApplication |
Commence le traitement d'un ensemble de modifications dans le cadre d'une synchronisation de récupération. |
Met fin au traitement d'un ensemble de modifications. |
|
IChangeApplicationServices::EndFullEnumerationChangeApplication |
Met fin au traitement d'un ensemble de modifications dans le cadre d'une synchronisation de récupération. |
Définit la connaissance de destination qui est utilisée pour calculer la connaissance de destination mise à jour lorsque des modifications sont appliquées. |
|
Obtient la connaissance de destination mise à jour qui contient toutes les modifications qui ont été appliquées jusqu'à présent. |
|
Obtient un objet qui représente la modification actuelle à appliquer. |
|
Signale au service d'application de modifications qu'une modification d'élément a été appliquée avec succès au réplica de destination. |
|
Signale au service d'application de modifications qu'une modification d'unité de modification a été appliquée avec succès au réplica de destination. |
|
IChangeApplicationServices::ReportRecoverableErrorOnItemChange |
Signale au service d'application de modifications qu'une erreur récupérable s'est produite lorsque le fournisseur de destination a essayé d'appliquer la modification d'élément. |
IChangeApplicationServices::ReportRecoverableErrorOnChangeUnitChange |
Signale au service d'application de modifications qu'une erreur récupérable s'est produite lorsque le fournisseur de destination a essayé d'appliquer la modification d'unité de modification. |
Notes
L'interface IChangeApplicationServices fait partie du service d'application de modifications de Sync Framework, utilisé lorsqu'un fournisseur requiert une plus grande souplesse que celle autorisée par l'applicateur de modifications standard fourni par Sync Framework. Par exemple, un fournisseur doit différer l'application de certaines modifications à la fin de la session de synchronisation. L'applicateur de modifications standard ne le permet pas. Le fournisseur peut utiliser le service d'application de modifications pour gérer la détection de conflit et le calcul de connaissance tout en conservant la possibilité de différer des modifications, si nécessaire.
Pour un fournisseur qui n'a pas besoin de la souplesse supplémentaire du service d'application de modifications, il peut être plus simple d'utiliser un applicateur de modifications standard, tel que ISynchronousNotifyingChangeApplier.
Le service d'application de modifications est généralement utilisé par un fournisseur de destination pour permettre l'implémentation des méthodes IKnowledgeSyncProvider::ProcessChangeBatch et IKnowledgeSyncProvider::ProcessFullEnumerationChangeBatch. Pour utiliser le service d'application de modifications, procédez comme suit :
Obtenez un objet IChangeApplicationServices en passant IID_IChangeApplicationServices à la méthode IProviderSyncServices::CreateChangeApplier.
Initialisez l'objet en appelant IChangeApplicationServices::Initialize.
Appelez IChangeApplicationServices::BeginChangeApplication pour commencer le traitement d'un lot de modifications, ou appelez IChangeApplicationServices::BeginFullEnumerationChangeApplication pour commencer le traitement d'un lot de modifications d'une synchronisation de récupération. Cette méthode est généralement appelée une fois pour chaque lot de modifications à traiter.
Énumérez les modifications dans le lot de modifications. Appelez IChangeApplicationServices::GetChangeApplicationContext une fois pour chaque modification et utilisez l'objet IChangeApplicationContext retourné pour appliquer la modification.
Appelez IChangeApplicationServices::ReportItemChangeApplied ou IChangeApplicationServices::ReportChangeUnitChangeApplied pour signaler que l'application des modifications a réussi. Appelez IChangeApplicationServices::ReportRecoverableErrorOnItemChange ou IChangeApplicationServices::ReportRecoverableErrorOnChangeUnitChange pour signaler que l'application des modifications a échoué.
Appelez IChangeApplicationServices::GetUpdatedDestinationKnowledge à tout moment pour récupérer la connaissance de destination mise à jour qui contient toutes les modifications appliquées jusqu'à présent.
Appelez IChangeApplicationServices::EndChangeApplication pour mettre fin au traitement d'un lot de modifications, ou appelez IChangeApplicationServices::EndFullEnumerationChangeApplication pour mettre fin au traitement d'un lot de modifications d'une synchronisation de récupération. Enregistrez la connaissance de destination mise à jour et les objets de connaissance oubliée de destination qui sont retournés par cette méthode.
Répétez les étapes 3 à 7 pour chaque lot de modifications reçu par le fournisseur de destination.
Spécifications
En-tête : Synchronization.h