/// <summary>
/// When overridden in a derived class, gets a change batch that contains item metadata for items that are not contained in the specified knowledge from the destination provider.
/// </summary>
/// <param name="batchSize">The number of changes to include in the change batch.</param>
/// <param name="destinationKnowledge">The knowledge from the destination provider. This knowledge must be mapped by calling <see cref="M:Microsoft.Synchronization.SyncKnowledge.MapRemoteKnowledgeToLocal(Microsoft.Synchronization.SyncKnowledge)"/> on the source knowledge before it can be used for change enumeration.</param>
/// <param name="changeDataRetriever">Returns an object that can be used to retrieve change data. It can be an <see cref="T:Microsoft.Synchronization.IChangeDataRetriever"/> object or a provider-specific object.</param>
/// <returns>
/// A change batch that contains item metadata for items that are not contained in the specified knowledge from the destination provider. Cannot be a null.
/// </returns>
public override ChangeBatch GetChangeBatch(uint batchSize, SyncKnowledge destinationKnowledge, out object changeDataRetriever)
{
byte[] rawDestinationKnowledge = destinationKnowledge.Serialize();
byte[] rawChangeDataRetriever;
byte[] rawChangeBatch = _syncService.GetChangeBatch(batchSize, rawDestinationKnowledge,
out rawChangeDataRetriever);
CachedChangeDataRetriever cachedRetriever =
SerializerHelper.BinaryDeserialize <CachedChangeDataRetriever>(rawChangeDataRetriever);
changeDataRetriever = cachedRetriever;
return(ChangeBatch.Deserialize(IdFormats, rawChangeBatch));
}
