IKnowledgeSyncProvider::GetFullEnumerationChangeBatch
Obtient un lot de modifications qui contient les métadonnées des éléments dont les ID sont supérieurs à la limite inférieure spécifiée, dans le cadre d'une énumération complète.
HRESULT GetFullEnumerationChangeBatch(
DWORD dwBatchSize,
const BYTE * pbLowerEnumerationBound,
ISyncKnowledge * pSyncKnowledge,
ISyncFullEnumerationChangeBatch ** ppSyncChangeBatch,
IUnknown ** ppUnkDataRetriever);
Paramètres
- dwBatchSize
[in] Nombre de modifications à inclure dans le lot de modifications.
- pbLowerEnumerationBound
[in] Limite inférieure pour les ID d'élément. Cette méthode retourne les modifications dont les ID sont supérieurs ou égaux à cette valeur d'ID.
- pSyncKnowledge
[in] Si une modification d'élément est contenue dans cet objet de connaissance, les données de cet élément existent déjà sur le réplica de destination.
- ppSyncChangeBatch
[out] Retourne un lot de modifications qui contient les métadonnées d'élément pour les éléments qui ont des ID supérieurs à la limite inférieure spécifiée.
- ppUnkDataRetriever
[out] Retourne un objet qui peut être utilisé pour récupérer des données de modification. Il peut s'agir d'un objet ISynchronousDataRetriever ou d'un objet spécifique au fournisseur.
Valeur de retour
S_OK
Codes d'erreur déterminés par le fournisseur
Notes
Cette méthode est appelée par Sync Framework pendant la récupération d'une connaissance oubliée.
Cette méthode énumère, en ordre trié par ID d'élément, les modifications ayant un ID d'élément supérieur ou égal à pbLowerEnumerationBound. Cela permet à Sync Framework d’identifier les éléments sur le fournisseur de destination qui ont été supprimés, mais oubliés par le fournisseur de source. Cette méthode peut éventuellement aussi ajouter des modifications au lot, trié par ID d'élément, dont les ID d'élément sont inférieurs à pbLowerEnumerationBound et qui ne sont pas contenues dans la connaissance de destination.
Remarques à l'attention des implémenteurs
S'il n'y a plus de modifications à envoyer après ce lot, vous devez appeler ISyncChangeBatchBase::SetLastBatch sur le lot de modifications retourné. Sinon, Sync Framework appelle encore la méthode GetFullEnumerationChangeBatch pour récupérer un autre lot de modifications.
Pour un fournisseur qui envoie des données d'élément avec des métadonnées de modification d'élément, pSyncKnowledge peut être utilisé pour déterminer s'il est nécessaire ou non d'envoyer des données d'élément. Il n'est pas nécessaire d'envoyer les données d'élément lorsque la modification d'élément est contenue dans pSyncKnowledge. Gardez à l'esprit qu'avant de pouvoir l'utiliser pour vérifier des éléments dans le cadre d'une relation contenant contenu, pSyncKnowledge doit être mappé en utilisant la méthode ISyncKnowledge::MapRemoteToLocal sur l'objet de connaissance contenu dans le fournisseur actuel.
Voir aussi
Référence
Interface IKnowledgeSyncProvider